Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation d’une clé d’API Amazon Bedrock
<a name="api-keys-use"></a>

Vous pouvez utiliser votre clé d’API Amazon Bedrock de la manière suivante :
+ **Définissez-la comme variable d’environnement** : le service Amazon Bedrock reconnaît la variable d’environnement `AWS_BEARER_TOKEN_BEDROCK`. Vous disposez des options suivantes pour définir la clé :
  + Ouvrez un terminal pour le définir :
    + **MacOS/Linux**

      ```
      export AWS_BEARER_TOKEN_BEDROCK=${api-key}
      ```
    + **Windows**

      ```
      setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"
      ```
  + Définissez-la comme variable d’environnement dans votre code avant de faire la demande d’API. Par exemple, vous pouvez inclure les lignes suivantes avant de faire la demande :
    + **Python**

      ```
      import os                      
      os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"
      ```
+ **Spécifiez-le dans une demande** : vous pouvez inclure la clé d’API Amazon Bedrock dans l’en-tête d’autorisation de la manière suivante (remplacez *\$1AWS\$1BEARER\$1TOKEN\$1BEDROCK* par la valeur réelle) :
  + **Dans une requête HTTP directe** : incluez ce qui suit dans l’en-tête d’autorisation :

    ```
    Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK
    ```
  + **En tant que paramètre dans un kit SDK pris en charge** : spécifiez la valeur du paramètre lors de la configuration du client. Par exemple, vous pouvez le spécifier dans le champ `api_key` lors de la configuration d’un client avec le [kit SDK OpenAI Python](https://github.com/openai/openai-python?tab=readme-ov-file#usage).

**Note**  
Les clés d’API Amazon Bedrock sont limitées aux actions [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) et d’[exécution d’Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html). Vous ne pouvez pas les utiliser avec les opérations d’API suivantes :  
[InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html).
Opérations d’API [Agents Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) ou [Exécution des agents Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html).
Opérations d’API [Automatisation des données Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Data_Automation_for_Amazon_Bedrock.html) ou [Automatisation des données d’exécution d’Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Runtime_for_Amazon_Bedrock_Data_Automation).

Pour voir un exemple d’utilisation de la clé d’API pour envoyer une requête [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) afin de générer une réponse, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes :

------
#### [ Python ]

L’exemple suivant montre comment envoyer une demande d’API avec AWS SDK pour Python (Boto3). Si vous n’avez pas encore défini la clé d’API comme variable d’environnement `AWS_BEARER_TOKEN_BEDROCK`, spécifiez-la à la place de *\$1\$1api-key\$1* dans le code suivant :

```
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) ]

**Condition préalable** : installez le package `requests` en ouvrant un terminal et en exécutant la commande suivante :

```
python3 -m pip install requests
```

L’exemple suivant montre comment envoyer directement une demande d’API avec un client HTTP. Spécifiez le *\$1\$1api-key\$1* dans l’en-tête.

```
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 ]

L’exemple suivant montre comment envoyer directement une demande d’API à l’aide de cURL. Si vous n’avez pas défini la clé d’API comme variable d’environnement AWS\$1BEARER\$1TOKEN\$1BEDROCK, vous devrez remplacer `$AWS_BEARER_TOKEN_BEDROCK` dans l’exemple par la valeur littérale de la clé.

```
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"}]
        }
    ]
  }'
```

------