Utiliser 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.

Utiliser une clé d'API Amazon Bedrock

Pour utiliser votre clé d'API, vous devez la définir comme variable d'environnement nommée AWS_BEARER_TOKEN_BEDROCK avant d'effectuer des appels d'API. Vous disposez des options suivantes pour définir la clé :

  • Ouvrez un terminal pour le configurer :

    • 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.

Note

Les clés d'API Amazon Bedrock ne peuvent pas être utilisées avec le InvokeModelWithBidirectionalStream.

Pour voir un exemple d'utilisation de la clé 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 suivantes :

Python

L'exemple suivant montre comment envoyer une demande d'API avec le AWS SDK pour Python (Boto3). Si vous n'avez pas encore défini la clé d'API comme variable d'AWS_BEARER_TOKEN_BEDROCKenvironnement, spécifiez-la à la place ${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)

Prérequis : installez le requests package 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' AWS_BEARER_TOKEN_BEDROCK environnement, vous devrez la 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"}]
        }
    ]
  }'