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

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 de AWS complejas.

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 en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 acciones principales de Amazon Bedrock, tal y como se define en la política asociada AmazonBedrockLimitedAccess.

  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 sustituyendo ${api-key} por el valor de la clave de API que haya generado y utilícela para generar una respuesta en el método que elija:

    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 cambiar a métodos de autenticación más seguros, como las claves de API de Amazon Bedrock de corta duración o las credenciales temporales para todo AWS. Para obtener más información consulte los siguientes recursos: