View a markdown version of this page

Introducción a las claves de API de Amazon Bedrock: generación de una clave de 30 días y ejecución de una primera llamada a la API - Amazon Bedrock

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción a las claves de API de Amazon Bedrock: generación de una clave de 30 días y ejecución de una primera llamada a la API

En este tutorial, se explica cómo crear una clave de API de Amazon Bedrock de larga duración que caduca a los 30 días y cómo utilizarla para realizar una llamada sencilla a la API Converse mediante Python. Esta es la forma más rápida de empezar a experimentar con Amazon Bedrock sin tener que configurar credenciales complejas AWS .

aviso

Long-term Las claves de API solo se recomiendan para la exploración y el desarrollo de Amazon Bedrock. Para las aplicaciones de producción, utilice alternativas a las claves de acceso de larga duración, como roles de IAM o credenciales temporales.

Siga estos pasos para crear una clave de API de Amazon Bedrock de larga duración que caduque a los 30 días:

  1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola Amazon Bedrock en https://console.aws.amazon.com/bedrock.

  2. En el panel de navegación izquierdo, seleccione Claves de API.

  3. En la pestaña Claves de Long-term API, selecciona Generar claves de API a largo plazo.

  4. En la sección Caducidad de la clave de API, seleccione 30 días.

  5. Seleccione Generar. La clave que genere proporciona permisos para llevar a cabo las principales acciones de Amazon Bedrock, tal y como se define en la AmazonBedrockLimitedAccesspolítica adjunta.

  6. Copie la clave de API generada y almacénela de forma segura. La necesitará para el siguiente paso.

    importante

    La clave de API solo se muestra una vez. Asegúrese de copiarla y guardarla antes de cerrar el cuadro de diálogo. Recuerde que su clave de API caducará en 30 días. Puede generar una nueva siguiendo los mismos pasos o considerar la posibilidad de utilizar métodos de autenticación más seguros para un uso continuado.

  7. Configure la clave de API como una variable de entorno ${api-key} sustituyéndola por el valor de clave de API generado y utilícela para generar una respuesta según el método que prefiera:

    Python
    import boto3
import os

# Set the API key as an environment variable
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

# Create the Bedrock client
client = boto3.client(
    service_name="bedrock-runtime",
    region_name="us-east-1"
)

# Define the model and message
model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
messages = [{"role": "user", "content": [{"text": "Hello! Can you tell me about Amazon Bedrock?"}]}]

# Make the API call
response = client.converse(
    modelId=model_id,
    messages=messages,
)

# Print the response
print(response['output']['message']['content'][0]['text'])
    HTTP client using Python
    import requests

url = "https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-haiku-20241022-v1:0/converse"

payload = {
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ${api-key}"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
    HTTP request using cURL
    curl -X POST "https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-haiku-20241022-v1:0/converse" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${api-key}" \
  -d '{
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
  }'

¡Enhorabuena! Ha generado correctamente una clave de API de Amazon Bedrock y ha realizado su primera llamada de API al servicio de Amazon Bedrock. Tras explorar más acciones de Amazon Bedrock, debería pasar a métodos de autenticación más seguros, como las claves de API de Amazon Bedrock a corto plazo o las credenciales temporales para AWS todo el mundo. Para obtener más información consulte los siguientes recursos:

  • Explore diferentes modelos: obtenga información sobre otros modelos fundacionales disponibles en Amazon Bedrock en Uso de modelos con Bedrock y cambie el model_id en su código para probarlos.

  • Obtenga información sobre la inferencia de modelos: obtenga información sobre cómo generar respuestas con la inferencia de modelos consultando los conceptos y las opciones disponibles en Amazon Bedrock en Realizar solicitudes de inferencia.

  • Planifique la producción con métodos de autenticación más seguros: lea más detalladamente sobre las claves de API de Amazon Bedrock en el capítulo Creación y sobre cómo crear claves de API de Amazon Bedrock más seguras y a corto plazo. Cuando esté listo para crear aplicaciones de producción, también debería revisar las alternativas a las claves de acceso a largo plazo para obtener opciones más seguras que también permitan el acceso a otros AWS servicios.