Uso de una clave de API de Amazon Bedrock - 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.

Uso de una clave de API de Amazon Bedrock

Puede utilizar su clave de API de Amazon Bedrock de las siguientes maneras:

  • Establézcala como variable de entorno: el servicio de Amazon Bedrock reconoce la variable de entorno AWS_BEARER_TOKEN_BEDROCK. Dispone de las siguientes opciones para configurar la clave:

    • Abra una ventana de terminal para configurarla:

      • MacOS/Linux

        export AWS_BEARER_TOKEN_BEDROCK=${api-key}

      • Windows

        setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

    • Establézcala como una variable de entorno en su código antes de realizar la solicitud de API. Por ejemplo, podría incluir las siguientes líneas antes de realizar la solicitud:

      • Python

        import os                      
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

  • Especifíquela en una solicitud: puede incluir la clave de API de Amazon Bedrock en el encabezado de autorización de las siguientes maneras (sustituya $AWS_BEARER_TOKEN_BEDROCK por el valor real):

    • En una solicitud HTTP directa: incluya lo siguiente como encabezado de autorización:

      Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

    • Como parámetro en un SDK compatible: especifique el valor del parámetro al configurar el cliente. Por ejemplo, puede especificarlo en el campo api_key al configurar un cliente con el SDK de Python de OpenAI.

nota

Las claves de API de Amazon Bedrock se limitan a las acciones de Amazon Bedrock y Tiempo de ejecución de Amazon Bedrock. No puede utilizarlas con las siguientes operaciones de API:

Para ver un ejemplo del uso de la clave de API para enviar una solicitud Converse y generar una respuesta, elige la pestaña correspondiente al método que prefiera y, a continuación, siga estos pasos:

Python

El siguiente ejemplo muestra cómo enviar una solicitud de API con AWS SDK para Python (Boto3). Si aún no ha configurado la clave de API como la variable de entorno AWS_BEARER_TOKEN_BEDROCK, especifíquela en lugar de ${api-key} en el siguiente código:

import os
import boto3
                        
# If you already set the API key as an environment variable, you can comment this line out                        
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

# Create an Amazon Bedrock client
client = boto3.client(
    service_name="bedrock-runtime",
    region_name="us-east-1" # If you've configured a default region, you can omit this line
)

# Define the model and message
model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
messages = [{"role": "user", "content": [{"text": "Hello"}]}]

response = client.converse(
    modelId=model_id,
    messages=messages,
)
HTTP Client (requests package in Python)

Requisito previo: instale el paquete requests abriendo una ventana de terminal y ejecutando el siguiente comando:

python3 -m pip install requests

El siguiente ejemplo muestra cómo enviar directamente una solicitud de API con un cliente HTTP. Especifique ${api-key} en el encabezado.

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

El siguiente ejemplo muestra cómo enviar directamente una solicitud de API con cURL. Si no ha configurado la clave de API como la variable de entorno AWS_BEARER_TOKEN_BEDROCK, tendrá que sustituir $AWS_BEARER_TOKEN_BEDROCK en el ejemplo por el valor literal de la clave.

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 $AWS_BEARER_TOKEN_BEDROCK" \
  -d '{
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
  }'