View a markdown version of this page

Démarrer avec les clés d’API Amazon Bedrock : génération d’une clé de 30 jours et réalisation de 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.

Démarrer avec les clés d’API Amazon Bedrock : génération d’une clé de 30 jours et réalisation de votre premier appel d’API

Ce didacticiel vous explique comment créer une clé d’API Amazon Bedrock à long terme qui expire au bout de 30 jours et comment l’utiliser pour effectuer un appel d’API Converse simple à l’aide de Python. Il s'agit de la méthode la plus rapide pour commencer à expérimenter Amazon Bedrock sans configurer d'informations d'identification complexes AWS .

Avertissement

Long-term Les clés d'API 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 au bout de 30 jours :

  1. Connectez-vous au Console de gestion AWS 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 panneau de navigation de gauche, sélectionnez Clés d’API.

  3. Dans l'onglet Clés Long-term d'API, 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. Choisissez Générer. La clé que vous générez fournit les autorisations nécessaires pour effectuer les actions principales d'Amazon Bedrock, comme défini dans la AmazonBedrockLimitedAccess politique ci-jointe.

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

    Important

    La clé d’API n’est affichée qu’une seule fois. Assurez-vous de la copier et de l’enregistrer avant de fermer la boîte de dialogue. N’oubliez pas que votre clé d’API expire au bout de 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é API en tant que variable d'environnement en la ${api-key} remplaçant par la valeur de votre clé 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é 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 temporaires pour l' AWS ensemble de l'entreprise. Pour en savoir plus, consultez les ressources suivantes :

  • Exploration de différents modèles : découvrez les autres modèles de fondation disponibles sur Amazon Bedrock dans Utiliser des modèles avec Bedrock et modifiez model_id dans votre code pour les essayer.

  • En savoir plus sur l’inférence de modèle : consultez Faire des demandes d'inférence pour apprendre comment générer des réponses avec l’inférence de modèle et découvrir les concepts et les options Amazon Bedrock.

  • Planifiez la production avec des méthodes d'authentification plus sécurisées  : découvrez les clés d'API Amazon Bedrock dans le chapitre Build, notamment comment créer des clés d'API Amazon Bedrock plus sécurisées et à court terme. Pour les applications de production, examinez les alternatives aux clés d'accès à long terme pour des options plus sécurisées qui permettent également l'accès à d'autres AWS services.