Utiliser 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 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. 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-la $AWS_BEARER_TOKEN_BEDROCK par la valeur réelle) :

  • Dans une requête HTTP directe : incluez ce qui suit en tant qu'en-tête d'autorisation :

    Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

  • En tant que paramètre dans un 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 api_key champ lors de la configuration d'un client avec le SDK OpenAI Python.

Note

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

• InvokeModelWithBidirectionalStream.

• Agents pour les opérations de l'API Amazon Bedrock ou Agents pour Amazon Bedrock Runtime.

• Automatisation des données pour Amazon Bedrock ou Runtime pour les opérations de l'API Amazon Bedrock Data Automation.

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