Claude dans Amazon Bedrock (Opus 4.7 et versions ultérieures)

Ce guide vous accompagne dans la configuration et l'exécution d'appels API vers Claude dans Amazon Bedrock. Claude dans Amazon Bedrock s'exécute sur une infrastructure gérée par AWS avec un accès opérateur nul (le personnel d'Anthropic n'a aucun accès à l'infrastructure d'inférence), ce qui vous permet de créer des applications sensibles entièrement à l'intérieur du périmètre de sécurité AWS tout en utilisant la même forme d'API Messages que celle que vous utilisez avec l'API de première partie d'Anthropic.



Accès

Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 et Claude Haiku 4.5 sont ouverts à tous les clients Amazon Bedrock. Claude Mythos Preview nécessite une invitation ; consultez Project Glasswing. Pour la disponibilité par région, consultez Régions.



Prérequis

Avant de commencer, assurez-vous de disposer de :

• Un compte AWS avec l'accès aux modèles Amazon Bedrock activé pour les modèles Claude que vous comptez utiliser.
• L'AWS CLI installée et configurée (facultatif, pour la gestion des identifiants).

Claude Mythos Preview nécessite en outre un compte AWS dédié qui a été ajouté à la liste d'autorisation par l'équipe Bedrock Marketplace. Votre responsable de compte Anthropic peut soumettre votre ID de compte pour l'ajout à la liste d'autorisation (généralement traité sous 24 heures), et AWS envoie un e-mail de bienvenue une fois l'opération terminée.



Authentification

Claude dans Amazon Bedrock prend en charge trois voies d'authentification. Choisissez celle qui correspond le mieux à vos exigences de sécurité.



Rôle de service Bedrock (recommandé)

Utilisez un rôle de service Bedrock avec des clés gérées par AWS pour l'accès le plus sécurisé et de longue durée :



Rôles IAM assumés

Pour un accès fédéré par identité avec une session maximale de 12 heures :



Jetons bearer

Pour un accès de courte durée sans rôles IAM (maximum 12 heures, option la moins recommandée) :



Installer un SDK

Les SDK clients d'Anthropic prennent en charge Claude dans Amazon Bedrock via un package ou un module spécifique à Bedrock.

pip install -U "anthropic[bedrock]"



Effectuer votre première requête

Le point de terminaison suit le modèle https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Contrairement à l'intégration basée sur InvokeModel, ce point de terminaison utilise le streaming SSE standard et la même forme de corps de requête que l'API de première partie d'Anthropic.

Le SDK résout les identifiants et la région en utilisant l'ordre de priorité AWS standard : les arguments du constructeur, puis les variables d'environnement (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), puis le fichier de configuration AWS et la chaîne d'identifiants (SSO, rôles assumés, rôle de tâche ECS, IMDS).

curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic.claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'



Modèles pris en charge

Les ID de modèle dans Claude dans Amazon Bedrock portent un préfixe de fournisseur anthropic.. Les capacités et comportements des modèles sont documentés sur la page Aperçu des modèles.



Prise en charge des fonctionnalités

Pour la liste complète des fonctionnalités avec leur disponibilité sur Amazon Bedrock, consultez Aperçu des fonctionnalités.



Principales fonctionnalités prises en charge

• API Messages (/anthropic/v1/messages)
• Mise en cache des prompts
• Réflexion étendue
• Utilisation d'outils, y compris l'outil Bash, l'outil d'utilisation de l'ordinateur, l'outil de mémoire et l'outil d'édition de texte
• Citations
• Sorties structurées



Fonctionnalités non prises en charge

• Sources d'entrée (sources URL pour les images et les documents, API Files)
• Outils côté serveur (exécution de code, recherche web, récupération web, advisor)
• Infrastructure d'agents (Agent Skills, connecteur MCP, appel d'outils programmatique)
• Points de terminaison d'API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Repli côté serveur (le paramètre fallbacks ; utilisez plutôt le modèle de repli côté client)



Régions

Claude dans Amazon Bedrock est disponible dans les régions AWS suivantes. Amazon Bedrock propose deux types de points de terminaison :

• Global : routage dynamique entre toutes les régions disponibles pour une disponibilité maximale. Aucun supplément tarifaire.
• Régional : le point de terminaison se résout vers la seule région AWS que vous spécifiez, pour les exigences de résidence des données. Les points de terminaison régionaux comportent un supplément tarifaire de 10 % par rapport aux points de terminaison globaux. Pour router entre plusieurs régions au sein d'une zone géographique, utilisez un profil d'inférence (US, EU, JP ou AU). Les régions marquées In-region only dans le tableau prennent en charge le routage direct vers une seule région sans profil d'inférence.

Le point de terminaison global est disponible pour Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 et Claude Haiku 4.5. Claude Mythos Preview est uniquement régional et est disponible dans us-east-1.



Quotas

Le quota par défaut est de 2 millions de tokens d'entrée par minute (TPM). Vous pouvez demander jusqu'à 4 millions de TPM d'entrée sans approbation supplémentaire d'Anthropic. AWS applique des limites de requêtes par minute (RPM) du côté Bedrock ; contactez le support AWS pour les ajustements de RPM.



Conservation des données

Le traitement des données pour cette offre est régi par Amazon Bedrock. Pour plus de détails, consultez Protection des données dans Amazon Bedrock.



Surveillance et journalisation

Claude dans Amazon Bedrock émet des journaux vers CloudWatch et CloudTrail. Anthropic recommande de conserver les journaux d'activité sur une base glissante d'au moins 30 jours afin de comprendre les schémas d'utilisation et d'enquêter sur les problèmes potentiels.



Support

Pour obtenir de l'aide, contactez [email protected]. Incluez votre ID de compte AWS et le request-id de toute réponse API en échec.