Claude sur Amazon Bedrock (bedrock-runtime)
Utilisez les modèles Claude sur le point de terminaison bedrock-runtime d’Amazon Bedrock, via les API InvokeModel et Converse.
L’appel de Claude via Bedrock diffère légèrement de la manière dont vous appelleriez Claude directement sur l’API Claude. Ce guide vous accompagne dans la réalisation d’un appel API à Claude sur Bedrock en utilisant l’un des SDK clients d’Anthropic.
Notez que ce guide suppose que vous vous êtes déjà inscrit à un compte AWS et que vous avez configuré l’accès programmatique.
Installer et configurer l’AWS CLI
- Installez une version de l’AWS CLI égale ou supérieure à la version
2.13.23. - Configurez vos identifiants AWS à l’aide de la commande AWS configure (consultez Configurer l’AWS CLI) ou trouvez vos identifiants en accédant à Command line or programmatic access dans votre tableau de bord AWS et en suivant les instructions de la fenêtre modale.
- Vérifiez que vos identifiants fonctionnent :
aws sts get-caller-identityInstaller un SDK pour accéder à Bedrock
Les SDK clients d’Anthropic prennent en charge Bedrock. Vous pouvez également utiliser directement un SDK AWS tel que boto3.
pip install -U "anthropic[bedrock]<2"Accéder à Bedrock
S’abonner aux modèles Anthropic
Rendez-vous dans AWS Console > Bedrock > Accès aux modèles et demandez l’accès aux modèles Anthropic. Notez que la disponibilité des modèles Anthropic varie selon la région. Consultez la documentation AWS sur la disponibilité des modèles par région pour obtenir les informations les plus récentes.
Identifiants de modèle de l’API
Les termes du cycle de vie (Déprécié, Retiré) sont définis dans Dépréciations de modèles. Les dates du cycle de vie sur les plateformes exploitées par des partenaires sont fixées par le partenaire et peuvent différer du calendrier de l’API Claude. Pour la date de retrait actuelle de n’importe quel modèle sur Amazon Bedrock, consultez la page sur le cycle de vie des modèles d’Amazon Bedrock.
AWS propose les modèles Claude plus récents via l’inférence inter-régions plutôt qu’avec un débit à la demande. Pour ces modèles, une requête qui transmet l’identifiant de modèle de base échoue avec une erreur HTTP 400 comme la suivante :
Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.Pour appeler ces modèles, transmettez un profil d’inférence au lieu de l’identifiant de modèle de base. L’identifiant du profil d’inférence est l’identifiant de modèle de base précédé d’un préfixe provenant d’une colonne marquée « Oui » dans le tableau suivant, par exemple us.anthropic.claude-sonnet-4-5-20250929-v1:0. Vous pouvez également transmettre l’ARN complet du profil d’inférence, sous la forme arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}. Pour la liste officielle d’AWS des profils d’inférence disponibles, consultez Régions et modèles pris en charge pour les profils d’inférence. Pour savoir comment les préfixes affectent le routage et la tarification, consultez la section Points de terminaison globaux ou régionaux.
| Modèle | ID du modèle Bedrock de base | global | us | eu | jp | apac |
|---|---|---|---|---|---|---|
| Claude Fable 5.2 | anthropic.claude-fable-5-2 | Oui | Oui | Non | Non | Non |
| Claude Mythos 5.2 (disponibilité limitée(s’ouvre dans un nouvel onglet)) | anthropic.claude-mythos-5-2 | Oui | Oui | Non | Non | Non |
| Claude Opus 4.6 | anthropic.claude-opus-4-6-v1 | Oui | Oui | Oui | Oui | Oui |
| Claude Opus 4.5 | anthropic.claude-opus-4-5-20251101-v1:0 | Oui | Oui | Oui | Non | Non |
| Claude Opus 4.1 (obsolète) | anthropic.claude-opus-4-1-20250805-v1:0 | Non | Oui | Non | Non | Non |
| Claude Sonnet 4.6 | anthropic.claude-sonnet-4-6 | Oui | Oui | Oui | Oui | Non |
| Claude Sonnet 4.5 (obsolète) | anthropic.claude-sonnet-4-5-20250929-v1:0 | Oui | Oui | Oui | Oui | Non |
| Claude Sonnet 4 (obsolète) | anthropic.claude-sonnet-4-20250514-v1:0 | Oui | Oui | Oui | Non | Oui |
| Claude Haiku 4.5 | anthropic.claude-haiku-4-5-20251001-v1:0 | Oui | Oui | Oui | Non | Non |
Lister les modèles disponibles
Les exemples suivants montrent comment afficher la liste de tous les modèles Claude disponibles via Bedrock :
import boto3
bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")
for summary in response["modelSummaries"]:
print(summary["modelId"])Effectuer des requêtes
Les exemples suivants montrent comment générer du texte avec Claude sur Bedrock :
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
# Authentifiez-vous en fournissant les clés suivantes ou en utilisant les fournisseurs d'identifiants AWS par défaut, par exemple
# via ~/.aws/credentials ou les variables d'environnement "AWS_SECRET_ACCESS_KEY" et "AWS_ACCESS_KEY_ID".
aws_access_key="<access key>",
aws_secret_key="<secret key>",
# Des identifiants temporaires peuvent être utilisés avec aws_session_token.
# Pour en savoir plus : https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
aws_session_token="<session_token>",
# aws_region modifie la région AWS à laquelle la requête est envoyée. Si elle n'est pas fournie, le SDK lit
# AWS_REGION / AWS_DEFAULT_REGION, puis la région configurée pour votre session boto3 ou votre profil AWS
# (y compris ~/.aws/config), et lève une ValueError si aucune région ne peut être déterminée.
aws_region="us-west-2",
)
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)Consultez les SDK clients pour plus de détails, ainsi que la documentation officielle de Bedrock.
Authentification par jeton bearer
Vous pouvez vous authentifier auprès de Bedrock à l’aide de jetons bearer au lieu d’identifiants AWS. Cela est utile dans les environnements d’entreprise où les équipes ont besoin d’accéder à Bedrock sans gérer d’identifiants AWS, de rôles IAM ou d’autorisations au niveau du compte.
L’approche la plus simple consiste à définir la variable d’environnement AWS_BEARER_TOKEN_BEDROCK, que le SDK détecte automatiquement lors de la résolution des identifiants à partir de l’environnement.
Pour fournir un jeton de manière programmatique :
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
api_key="your-bearer-token",
aws_region="us-west-2",
)
message = client.messages.create(
model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Journalisation de l’activité
Bedrock fournit un service de journalisation des invocations qui vous permet de journaliser les prompts et les complétions associés à votre utilisation.
Anthropic vous recommande de journaliser votre activité sur une période glissante d’au moins 30 jours afin de comprendre votre activité et d’enquêter sur tout abus potentiel.
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 MessagesAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir.
- 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’é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, Files API)
- 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 de l’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) - Mise en cache automatique des prompts (le champ
cache_controlde niveau supérieur ; utilisez plutôt des points d’arrêt de cache explicites)
Ensembles d’outils d’utilisation de l’ordinateur et d’utilisation du navigateur sur Bedrock
Les ensembles d’outils d’utilisation de l’ordinateur et d’utilisation du navigateur sont disponibles via l’API InvokeModel pour les modèles suivants :
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Fable 5.1
- Claude Fable 5
- Claude Opus 5.5
- Claude Opus 5
- Claude Opus 4.8
- Claude Sonnet 5.5
- Claude Sonnet 5
- Claude Haiku 5.5
Pour en utiliser un, ajoutez une entrée de type computer_toolset_20260801 ou browser_toolset_20260801 au tableau tools. Aucun en-tête bêta n’est requis pour l’un ou l’autre de ces ensembles d’outils.
Prise en charge des PDF sur Bedrock
La prise en charge des PDF est disponible sur Bedrock via la Converse API et l’InvokeModel API.
Messages système en cours de conversation sur Bedrock
Les messages système en cours de conversation sont disponibles via l’API InvokeModel pour Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Sonnet 5.5 et Claude Haiku 5.5. Cette fonctionnalité n’est pas disponible sur Claude Sonnet 5. Utilisez plutôt le champ system de niveau supérieur. Elle n’est pas disponible pour les autres modèles du tableau des modèles de cette page.
Un message role: "system" peut également définir output_config.effort pour modifier l’effort en cours de conversation sur Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1 et Claude Opus 5.5. Cette fonctionnalité est en bêta : ajoutez mid-conversation-output-config-2026-07-01 au tableau anthropic_beta dans le corps de la requête. Sans cette valeur, ou sur Claude Fable 5, Claude Opus 5 ou Claude Opus 4.8, la requête renvoie une erreur 400 : messages.N.output_config: Extra inputs are not permitted. Dans l’erreur, N est l’index du message system dans messages.
Pour les utilisateurs de l’API Converse : l’API Converse accepte les instructions système via son paramètre system de niveau supérieur. Pour ajouter des instructions système en cours de conversation, utilisez l’API InvokeModel.
Fenêtre de contexte
Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6 et Claude Haiku 5.5 disposent d’une « context window » (fenêtre de contexte) de 1M de tokens sur Amazon Bedrock. Les autres modèles Claude, y compris Sonnet 4.5 (déprécié) et Sonnet 4 (déprécié), disposent d’une fenêtre de contexte de 200k tokens.
Bedrock limite la charge utile des requêtes à 20 Mo. Lors de l’envoi de documents volumineux ou de nombreuses images, vous pourriez atteindre cette limite avant la limite de tokens.
Points de terminaison globaux ou régionaux
À partir de Claude Sonnet 4.5 et de tous les modèles futurs, Bedrock propose deux types de points de terminaison :
- Points de terminaison globaux : routage dynamique pour une disponibilité maximale
- Points de terminaison régionaux : routage des données garanti à travers des régions géographiques spécifiques
Les points de terminaison régionaux comportent une majoration tarifaire de 10 pour cent par rapport aux points de terminaison globaux.
Quand utiliser chaque option
Points de terminaison globaux (recommandés) :
- Offrent une disponibilité et un temps de fonctionnement maximaux
- Acheminent dynamiquement les requêtes vers les régions disposant de capacité disponible
- N’entraînent aucune majoration tarifaire
- Conviennent le mieux aux applications pour lesquelles la résidence des données est flexible
Points de terminaison régionaux (CRIS) :
- Acheminent le trafic à travers des régions géographiques spécifiques
- Sont requis pour les exigences de résidence des données et de conformité
- Sont disponibles pour les États-Unis, l’UE, le Japon et l’Asie-Pacifique
- Entraînent une majoration tarifaire de 10 pour cent qui reflète les coûts d’infrastructure liés à la capacité régionale dédiée
Mise en œuvre
Utilisation des points de terminaison globaux (par défaut pour Opus 4.6, Sonnet 4.6 et Sonnet 4.5 (déprécié)) :
Les identifiants de modèle de Claude Opus 4.6, Sonnet 4.6 et Sonnet 4.5 (déprécié) incluent déjà le préfixe global. :
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)Utilisation des points de terminaison régionaux (CRIS) :
Pour utiliser les points de terminaison régionaux, remplacez le préfixe global. par un préfixe régional tel que us. :
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
# Utilisation du point de terminaison régional US (CRIS)
message = client.messages.create(
model="us.anthropic.claude-opus-4-6-v1", # Regional prefix
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)Ressources supplémentaires
- Tarification de Bedrock : Page de tarification d’Amazon Bedrock
- Documentation de tarification AWS : Guide de tarification de Bedrock
- Article de blog AWS : Introducing Claude Sonnet 4.5 in Amazon Bedrock
- Détails de la tarification Anthropic : Tarification des plateformes cloud
Cette page vous a-t-elle été utile ?