Appeler Claude via Bedrock diffère légèrement de la façon dont vous appelleriez Claude en utilisant les SDK clients d’Anthropic. Ce guide vous guidera à travers le processus de complétion d’un appel API vers Claude sur Bedrock en Python ou TypeScript.

Notez que ce guide suppose que vous vous êtes déjà inscrit pour un compte AWS et configuré l’accès programmatique.

Installer et configurer l’AWS CLI

  1. Installez une version de l’AWS CLI à la version 2.13.23 ou plus récente
  2. Configurez vos identifiants AWS en utilisant la commande AWS configure (voir Configurer l’AWS CLI) ou trouvez vos identifiants en naviguant vers “Accès en ligne de commande ou programmatique” dans votre tableau de bord AWS et en suivant les instructions dans la fenêtre modale popup.
  3. Vérifiez que vos identifiants fonctionnent :
Shell
aws sts get-caller-identity

Installer un SDK pour accéder à Bedrock

Les SDK clients d’Anthropic prennent en charge Bedrock. Vous pouvez également utiliser un SDK AWS comme boto3 directement.

pip install -U "anthropic[bedrock]"

Accéder à Bedrock

S’abonner aux modèles Anthropic

Allez à la Console AWS > 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. Voir la documentation AWS pour les informations les plus récentes.

Noms des modèles API

ModèleNom du modèle API Bedrock
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0
Claude Sonnet 3.7anthropic.claude-3-7-sonnet-20250219-v1:0
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0
Claude Sonnet 3.5anthropic.claude-3-5-sonnet-20241022-v2:0
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3 anthropic.claude-3-sonnet-20240229-v1:0
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0

Lister les modèles disponibles

Les exemples suivants montrent comment imprimer une liste de tous les modèles Claude disponibles via Bedrock :

aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

Faire des requêtes

Les exemples suivants montrent comment générer du texte à partir de Claude sur Bedrock :

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authentifiez-vous en fournissant les clés ci-dessous ou utilisez les fournisseurs d'identifiants AWS par défaut, tels que
    # utiliser ~/.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>",
    # Les identifiants temporaires peuvent être utilisés avec aws_session_token.
    # En savoir plus sur https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region change la région aws vers laquelle la requête est faite. Par défaut, nous lisons AWS_REGION,
    # et si ce n'est pas présent, nous utilisons us-east-1 par défaut. Notez que nous ne lisons pas ~/.aws/config pour la région.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="anthropic.claude-opus-4-20250514-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)

Voir nos SDK clients pour plus de détails, et la documentation officielle Bedrock ici.

Journalisation des activités

Bedrock fournit un service de journalisation des invocations qui permet aux clients de journaliser les invites et les complétions associées à votre utilisation.

Anthropic recommande que vous journalisiez votre activité sur au moins une base glissante de 30 jours afin de comprendre votre activité et d’enquêter sur toute utilisation abusive potentielle.

Activer ce service ne donne à AWS ou Anthropic aucun accès à votre contenu.

Support des fonctionnalités

Vous pouvez trouver toutes les fonctionnalités actuellement prises en charge sur Bedrock ici.

Support PDF sur Bedrock

Le support PDF est disponible sur Amazon Bedrock via l’API Converse et l’API InvokeModel. Pour des informations détaillées sur les capacités et limitations de traitement PDF, voir la documentation du support PDF.

Considérations importantes pour les utilisateurs de l’API Converse :

  • L’analyse visuelle PDF (graphiques, images, mises en page) nécessite que les citations soient activées
  • Sans citations, seule l’extraction de texte de base est disponible
  • Pour un contrôle total sans citations forcées, utilisez l’API InvokeModel

Pour plus de détails sur les deux modes de traitement de documents et leurs limitations, référez-vous au guide de support PDF.