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 structure d'API Messages que celle de l'API propriétaire d'Anthropic.



Accès

Amazon Bedrock définit des critères d'accès pour chaque modèle Claude individuellement. 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 ; pour connaître les critères actuels de tout autre modèle, consultez Accès aux modèles Amazon Bedrock dans la console AWS. 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 des éléments suivants :

• Un compte AWS avec l'accès aux modèles Amazon Bedrock activé pour les modèles Claude que vous prévoyez d'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 méthodes 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 durable :



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 à court terme sans rôles IAM (12 heures maximum, option la moins recommandée) :



Installer un SDK

Les SDK clients d'Anthropic prennent en charge Claude dans Amazon Bedrock via un package ou 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 structure de corps de requête que l'API propriétaire d'Anthropic.

Le SDK résout les identifiants et la région en utilisant l'ordre de priorité AWS standard : arguments du constructeur, puis 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).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))



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 Vue d'ensemble des modèles.



Prise en charge des fonctionnalités

Pour la liste complète des fonctionnalités avec leur disponibilité sur Amazon Bedrock, consultez Vue d'ensemble des fonctionnalités.



Principales fonctionnalités prises en charge

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



Fonctionnalités non prises en charge

• Sorties structurées
• Sources d'entrée (sources URL pour les images et documents, API Files)
• Outils côté serveur (exécution de code, recherche web, récupération web, advisor)
• Infrastructure d'agent (Agent Skills, connecteur MCP, appel d'outils programmatique)
• Points de terminaison 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 sur 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 entraînent un supplément tarifaire de 10 % par rapport aux points de terminaison globaux. Pour router sur 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 (en région uniquement) 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 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) 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 modèles 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 ayant échoué.