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

Las claves de API de larga duración 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 de 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 API de larga duración, seleccione Generar claves de API de larga duración.

  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 Información del modelo fundacional de Amazon 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 Envío de solicitudes y generación de respuestas con inferencia de modelos.

  • 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.