Usa una clave de API de Amazon Bedrock

Puedes usar tu clave de API de Amazon Bedrock de las siguientes maneras:

• Configúrela como variable de entorno: el servicio Amazon Bedrock reconoce la variable de entorno. AWS_BEARER_TOKEN_BEDROCK Dispone de las siguientes opciones para configurar la clave:

  • Abra una terminal para configurarla:

    • macOS/Linux

      export AWS_BEARER_TOKEN_BEDROCK=${api-key}

    • Windows

      setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

  • Configúrala como una variable de entorno en tu código antes de realizar la solicitud a la API. Por ejemplo, puedes incluir las siguientes líneas antes de realizar la solicitud:

    • Python

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

• Especificarlo en una solicitud: puedes incluir la clave de API de Amazon Bedrock en el encabezado de autorización de las siguientes maneras ($AWS_BEARER_TOKEN_BEDROCKsustituirla 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 api_key campo al configurar un cliente con el SDK de OpenAI Python.

nota

Las claves de API de Amazon Bedrock se limitan a las acciones de Amazon Bedrock y Amazon Bedrock Runtime. No puede usarlas con las siguientes operaciones de API:

• InvokeModelWithBidirectionalStream.

• Agentes para las operaciones de la API Amazon Bedrock o agentes para las operaciones de la API Amazon Bedrock Runtime.

• Data Automation para Amazon Bedrock o Runtime para las operaciones de la API de automatización de datos de Amazon Bedrock.

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

Python

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

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 requests paquete abriendo una 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. Especifica el ${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

En el siguiente ejemplo, se muestra cómo enviar directamente una solicitud de API mediante cURL. Si no configuraste la clave de API como variable de AWS_BEARER_TOKEN_BEDROCK entorno, tendrás que sustituirla $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"}]
        }
    ]
  }'