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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) simple à 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys), 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 AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Dans le panneau de navigation de gauche, sélectionnez **Clés d’API**. 1. Dans l’onglet **Clés d’API de longue durée**, choisissez **Générer des clés d’API de longue durée**. 1. Dans la section **Expiration de la clé API**, sélectionnez **30 jours**. 1. Choisissez **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 [AmazonBedrockLimitedAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockLimitedAccess)politique ci-jointe. 1. 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. 1. Définissez la clé d'API comme variable d'environnement en la *\$1\$1api-key\$1* 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 \$1 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 AWS temporaires étendues. 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 [Informations sur le modèle de fondation Amazon Bedrock](foundation-models-reference.md) et modifiez `model_id` dans votre code pour les essayer. + **En savoir plus sur l’inférence de modèle** : consultez [Soumission d’invites et génération de réponses à l’aide de l’inférence de modèle](inference.md) 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 plus en détail les clés d'API Amazon Bedrock dans le chapitre Build et découvrez comment créer des clés d'API Amazon Bedrock plus sécurisées et à court terme. Lorsque vous êtes prêt à créer des applications de production, vous devez également envisager [des alternatives aux clés d'accès à long terme](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) pour des options plus sécurisées qui permettent également d'accéder à d'autres AWS services.