Utilisation d’une clé d’API Amazon Bedrock - Amazon Bedrock

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

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 $AWS_BEARER_TOKEN_BEDROCK 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.

Note

Les clés d’API Amazon Bedrock sont limitées aux actions Amazon Bedrock et d’exécution d’Amazon Bedrock. Vous ne pouvez pas les utiliser avec les opérations d’API suivantes :

Pour voir un exemple d’utilisation de la clé d’API pour envoyer une requête Converse 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 ${api-key} 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 ${api-key} 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_BEARER_TOKEN_BEDROCK, 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"}]
        }
    ]
  }'