Claude sur Amazon Bedrock

L'appel de Claude via Bedrock diffère légèrement de la façon dont vous appelleriez Claude lors de l'utilisation des SDK clients d'Anthropic. Ce guide vous guide à travers 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 pour un compte AWS et que vous avez 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 à la ligne de commande ou accès programmatique » dans votre tableau de bord AWS et en suivant les instructions dans la fenêtre modale contextuelle.
3. Vérifiez que vos identifiants fonctionnent :

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 directement un SDK AWS comme boto3.

Accéder à Bedrock

S'abonner aux modèles Anthropic

Allez à AWS Console > Bedrock > Model Access 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 pour les dernières informations.

ID de modèle API

Pour plus d'informations sur les ID de modèle régionaux par rapport aux mondiaux, consultez la section Points de terminaison mondiaux vs régionaux ci-dessous.

Lister les modèles disponibles

Les exemples suivants montrent comment imprimer une 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 demandes

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 en utilisant les fournisseurs de credentials AWS par défaut, tels que
    # en utilisant ~/.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 credentials temporaires peuvent être utilisées 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 demande est effectuée. Par défaut, nous lisons AWS_REGION,
    # et si ce n'est pas présent, nous utilisons par défaut us-east-1. Notez que nous ne lisons pas ~/.aws/config pour la région.
    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, et la documentation officielle de Bedrock.

Authentification par jeton porteur

Vous pouvez vous authentifier auprès de Bedrock en utilisant des jetons porteurs au lieu des credentials AWS. Ceci est utile dans les environnements d'entreprise où les équipes ont besoin d'accès à Bedrock sans gérer les credentials AWS, les rôles IAM ou les autorisations au niveau du compte.

L'approche la plus simple est de définir la variable d'environnement AWS_BEARER_TOKEN_BEDROCK, qui est automatiquement détectée par la résolution des credentials fromEnv().

Pour fournir un jeton par programmation :

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-east-1",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

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 tout abus potentiel.

Support des fonctionnalités

Pour toutes les fonctionnalités actuellement prises en charge sur Bedrock, consultez Aperçu des fonctionnalités de l'API.

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 les limitations du traitement des PDF, consultez la documentation du support PDF.

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

• L'analyse visuelle des PDF (graphiques, images, mises en page) nécessite l'activation des citations
• Sans citations, seule l'extraction de texte basique 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 des documents et leurs limitations, consultez le guide du support PDF.

Fenêtre de contexte

Claude Opus 4.6 et Claude Sonnet 4.6 ont une fenêtre de contexte de 1M de jetons sur Amazon Bedrock. Les autres modèles Claude, y compris Sonnet 4.5 et Sonnet 4 (déprécié), ont une fenêtre de contexte de 200k jetons.

Amazon Bedrock limite les charges utiles des demandes à 20 Mo. Lors de l'envoi de documents volumineux ou de nombreuses images, vous pouvez atteindre cette limite avant la limite de jetons.

Points de terminaison mondiaux vs régionaux

À partir de Claude Sonnet 4.5 et tous les modèles futurs, Amazon Bedrock offre deux types de points de terminaison :

• Points de terminaison mondiaux : Routage dynamique pour une disponibilité maximale
• Points de terminaison régionaux : Routage des données garanti via des régions géographiques spécifiques

Les points de terminaison régionaux incluent une prime tarifaire de 10 % par rapport aux points de terminaison mondiaux.

Quand utiliser chaque option

Points de terminaison mondiaux (recommandé) :

• Fournissent une disponibilité et un temps d'activité maximaux
• Acheminent dynamiquement les demandes vers les régions avec capacité disponible
• Aucune prime tarifaire
• Idéal pour les applications où la résidence des données est flexible

Points de terminaison régionaux (CRIS) :

• Acheminent le trafic via des régions géographiques spécifiques
• Requis pour les exigences de résidence des données et de conformité
• Disponibles pour les États-Unis, l'UE, le Japon et l'Australie
• Prime tarifaire de 10 % reflétant les coûts d'infrastructure pour la capacité régionale dédiée

Implémentation

Utilisation des points de terminaison mondiaux (par défaut pour Opus 4.6, Sonnet 4.5 et Sonnet 4 (déprécié)) :

Les ID de modèle pour Claude Sonnet 4.5 et 4 (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, supprimez le préfixe global. de l'ID de modèle :

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="anthropic.claude-opus-4-6-v1",  # Pas de préfixe global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Ressources supplémentaires

• Tarification AWS Bedrock : aws.amazon.com/bedrock/pricing
• Documentation de tarification AWS : Guide de tarification de Bedrock
• Article de blog AWS : Présentation de Claude Sonnet 4.5 dans Amazon Bedrock
• Détails de tarification Anthropic : Documentation de tarification