Claude sur Amazon Bedrock (hérité)

Appeler 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 vers Claude sur Bedrock en utilisant l'un des SDK clients d'Anthropic.

Notez que ce guide suppose que vous avez déjà créé un compte AWS et configuré l'accès programmatique.

Installer et configurer l'AWS CLI

1. Installez une version de l'AWS CLI égale ou supérieure à la version 2.13.23
2. Configurez vos identifiants AWS à l'aide de la commande AWS configure (voir Configurer l'AWS CLI) ou trouvez vos identifiants en naviguant vers « Command line or programmatic access » dans votre tableau de bord AWS et en suivant les instructions de la fenêtre modale.
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

Accédez à 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 obtenir les informations les plus récentes.

Identifiants de modèle API

Les termes de cycle de vie (Déprécié, Retiré) sont définis dans Dépréciations de modèles. Les dates de 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 connaître la date de retrait actuelle de tout modèle sur Amazon Bedrock, consultez la page de cycle de vie des modèles d'Amazon Bedrock.

Pour plus d'informations sur les identifiants de modèle régionaux par rapport aux identifiants globaux, consultez la section Points de terminaison globaux vs régionaux.

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 à partir de Claude sur Bedrock :

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authentifiez-vous en fournissant les clés ci-dessous ou via les fournisseurs d'identifiants AWS par défaut, comme
    # le fichier ~/.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, consultez https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region modifie la région AWS vers laquelle la requête est envoyée. Par défaut, le SDK lit AWS_REGION,
    # et si absente, utilise us-east-1. Notez que le SDK ne lit 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, ainsi que la documentation officielle de Bedrock.

Authentification par jeton porteur

Vous pouvez vous authentifier auprès de Bedrock à l'aide de jetons porteurs (bearer tokens) 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 de permissions au niveau du compte.

L'approche la plus simple consiste à définir la variable d'environnement AWS_BEARER_TOKEN_BEDROCK, que chaque SDK détecte automatiquement lors de la résolution des identifiants à partir de l'environnement.

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-west-2",
    }
);

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 prompts et les complétions associés à leur utilisation.

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

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
• 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 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)

Prise en charge des PDF sur Bedrock

La prise en charge des PDF est disponible sur Bedrock via l'API Converse et l'API InvokeModel. Pour des informations détaillées sur les capacités et limitations du traitement des PDF, consultez Prise en charge des PDF sur Amazon Bedrock.

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 de base est disponible
• Pour un contrôle total sans citations forcées, utilisez l'API InvokeModel

Fenêtre de contexte

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 et Claude Sonnet 4.6 disposent d'une fenêtre de contexte de 1 million de tokens sur Amazon Bedrock. Les autres modèles Claude, y compris Sonnet 4.5 et Sonnet 4 (déprécié), disposent d'une fenêtre de contexte de 200 000 tokens.

Bedrock limite les charges utiles des requêtes à 20 Mo. Lors de l'envoi de documents volumineux ou de nombreuses images, vous pouvez atteindre cette limite avant la limite de tokens.

Points de terminaison globaux vs régionaux

À partir de Claude Sonnet 4.5 et 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 via des régions géographiques spécifiques

Les points de terminaison régionaux incluent un supplément tarifaire de 10 % 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
• Aucun supplément 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'Asie-Pacifique
• Le supplément tarifaire de 10 % reflète les coûts d'infrastructure pour une capacité régionale dédiée

Implémentation

Utilisation des points de terminaison globaux (par défaut pour Opus 4.6, Sonnet 4.6 et Sonnet 4.5) :

Les identifiants de modèle pour Claude Opus 4.6, Sonnet 4.6 et Sonnet 4.5 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 Bedrock : aws.amazon.com/bedrock/pricing
• Documentation tarifaire AWS : Guide de tarification Bedrock
• Article de blog AWS : Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Détails de tarification Anthropic : Tarification des plateformes cloud