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
<a name="api-keys-use"></a>

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 *\$1AWS\$1BEARER\$1TOKEN\$1BEDROCK* 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](https://github.com/openai/openai-python?tab=readme-ov-file#usage).

**nota**  
Las claves de API de Amazon Bedrock se limitan a las acciones de [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) y [Tiempo de ejecución de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html). No puede utilizarlas con las siguientes operaciones de API:  
[InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html)
Operaciones de API de [Agentes para Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) o [Tiempo de ejecución de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html)
Operaciones de API de [Automatización de Datos de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Data_Automation_for_Amazon_Bedrock.html) o [Tiempo de ejecución de Automatización de Datos de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Runtime_for_Amazon_Bedrock_Data_Automation)

Para ver un ejemplo del uso de la clave de API para enviar una solicitud [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) 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 *\$1\$1api-key\$1* 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 *\$1\$1api-key\$1* 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\$1BEARER\$1TOKEN\$1BEDROCK, 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"}]
        }
    ]
  }'
```

------