Commencez avec les clés d'API Amazon Bedrock : générez une clé de 30 jours et effectuez votre premier appel d'API - 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.

Commencez avec les clés d'API Amazon Bedrock : générez une clé de 30 jours et effectuez votre premier appel d'API

Ce didacticiel vous explique comment créer une clé d'API Amazon Bedrock à long terme qui expire dans 30 jours et comment l'utiliser pour effectuer un simple appel d'API Converse à l'aide de Python. C'est le moyen le plus rapide de commencer à expérimenter avec Amazon Bedrock sans avoir à configurer d'identifiants complexes AWS .

Avertissement

Les clés d'API à long terme sont recommandées uniquement pour l'exploration et le développement d'Amazon Bedrock. Pour les applications de production, utilisez des alternatives aux clés d'accès à long terme, telles que les rôles IAM ou les informations d'identification temporaires.

Suivez ces étapes pour créer une clé d'API Amazon Bedrock à long terme qui expirera dans 30 jours :

  1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à https://console.aws.amazon.com/bedrock/l'adresse.

  2. Dans le volet de navigation de gauche, sélectionnez les clés d'API.

  3. Dans l'onglet Clés d'API à long terme, choisissez Générer des clés d'API à long terme.

  4. Dans la section Expiration de la clé API, sélectionnez 30 jours.

  5. Sélectionnez Generate (Générer). La clé que vous générez fournit les autorisations nécessaires pour effectuer les actions principales d'Amazon Bedrock, telles que définies dans la AmazonBedrockLimitedAccesspolitique ci-jointe.

  6. Copiez la clé API générée et stockez-la en toute sécurité. Vous aurez besoin de cette clé pour passer à l'étape suivante.

    Important

    La clé d'API n'est affichée qu'une seule fois. Assurez-vous de le copier et de l'enregistrer avant de fermer la boîte de dialogue. N'oubliez pas que votre clé d'API expirera dans 30 jours. Vous pouvez en générer une nouvelle en suivant les mêmes étapes ou envisager de passer à des méthodes d'authentification plus sécurisées pour une utilisation continue.

  7. Définissez la clé d'API comme variable d'environnement en la ${api-key} remplaçant par la valeur de votre clé d'API générée et utilisez-la pour générer une réponse selon la méthode de votre choix :

    Python
    import boto3
import os

# Set the API key as an environment variable
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

# Create the Bedrock client
client = boto3.client(
    service_name="bedrock-runtime",
    region_name="us-east-1"
)

# Define the model and message
model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
messages = [{"role": "user", "content": [{"text": "Hello! Can you tell me about Amazon Bedrock?"}]}]

# Make the API call
response = client.converse(
    modelId=model_id,
    messages=messages,
)

# Print the response
print(response['output']['message']['content'][0]['text'])
    HTTP client using Python
    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
    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 ${api-key}" \
  -d '{
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
  }'

Félicitations ! Vous avez généré avec succès une clé d'API Amazon Bedrock et effectué votre premier appel d'API au service Amazon Bedrock. Après avoir exploré d'autres actions Amazon Bedrock, vous devriez passer à des méthodes d'authentification plus sécurisées, telles que des clés d'API Amazon Bedrock à court terme ou des informations d'identification AWS temporaires étendues. Consultez les ressources suivantes pour en savoir plus :