Chiamare Claude tramite Bedrock differisce leggermente da come chiameresti Claude quando usi gli SDK client di Anthropic. Questa guida ti guiderà attraverso il processo di completamento di una chiamata API a Claude su Bedrock in Python o TypeScript.
Nota che questa guida presuppone che tu abbia già registrato un account AWS e configurato l'accesso programmatico.
2.13.23 o successivaaws sts get-caller-identityGli SDK client di Anthropic supportano Bedrock. Puoi anche usare direttamente un SDK AWS come boto3.
pip install -U "anthropic[bedrock]"Vai a AWS Console > Bedrock > Model Access e richiedi l'accesso ai modelli Anthropic. Nota che la disponibilità dei modelli Anthropic varia per regione. Vedi la documentazione AWS per le informazioni più recenti.
| Modello | ID modello Bedrock base | global | us | eu | jp | apac |
|---|---|---|---|---|---|---|
| Claude Sonnet 4.5 | anthropic.claude-sonnet-4-5-20250929-v1:0 | Sì | Sì | Sì | Sì | No |
| Claude Sonnet 4 | anthropic.claude-sonnet-4-20250514-v1:0 | Sì | Sì | Sì | No | Sì |
| Claude Sonnet 3.7 ⚠️ | anthropic.claude-3-7-sonnet-20250219-v1:0 | No | Sì | Sì | No | Sì |
| Claude Opus 4.5 | anthropic.claude-opus-4-5-20251101-v1:0 | Sì | Sì | Sì | No | No |
| Claude Opus 4.1 | anthropic.claude-opus-4-1-20250805-v1:0 | No | Sì | No | No | No |
| Claude Opus 4 | anthropic.claude-opus-4-20250514-v1:0 | No | Sì | No | No | No |
| Claude Opus 3 ⚠️ | anthropic.claude-3-opus-20240229-v1:0 | No | Sì | No | No | No |
| Claude Haiku 4.5 | anthropic.claude-haiku-4-5-20251001-v1:0 | Sì | Sì | Sì | No | No |
| Claude Haiku 3.5 ⚠️ | anthropic.claude-3-5-haiku-20241022-v1:0 | No | Sì | No | No | No |
| Claude Haiku 3 | anthropic.claude-3-haiku-20240307-v1:0 | No | Sì | Sì | No | Sì |
Per ulteriori informazioni sugli ID modello regionali rispetto a quelli globali, vedi la sezione Endpoint globali vs regionali di seguito.
I seguenti esempi mostrano come stampare un elenco di tutti i modelli Claude disponibili tramite Bedrock:
aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"I seguenti esempi mostrano come generare testo da Claude su Bedrock:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
# Autentica fornendo le chiavi di seguito oppure usa i provider di credenziali AWS predefiniti, come
# usando ~/.aws/credentials o le variabili di ambiente "AWS_SECRET_ACCESS_KEY" e "AWS_ACCESS_KEY_ID".
aws_access_key="<access key>",
aws_secret_key="<secret key>",
# Le credenziali temporanee possono essere utilizzate con aws_session_token.
# Leggi di più su https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
aws_session_token="<session_token>",
# aws_region cambia la regione aws a cui viene effettuata la richiesta. Per impostazione predefinita, leggiamo AWS_REGION,
# e se non è presente, usiamo per impostazione predefinita us-east-1. Nota che non leggiamo ~/.aws/config per la regione.
aws_region="us-west-2",
)
message = client.messages.create(
model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)Vedi i nostri SDK client per ulteriori dettagli, e la documentazione ufficiale di Bedrock qui.
Bedrock fornisce un servizio di registrazione dell'invocazione che consente ai clienti di registrare i prompt e i completamenti associati al tuo utilizzo.
Anthropic consiglia di registrare la tua attività su almeno una base mobile di 30 giorni per comprendere la tua attività e investigare qualsiasi potenziale abuso.
L'attivazione di questo servizio non dà ad AWS o Anthropic alcun accesso ai tuoi contenuti.
Puoi trovare tutte le funzionalità attualmente supportate su Bedrock qui.
Il supporto PDF è disponibile su Amazon Bedrock tramite sia l'API Converse che l'API InvokeModel. Per informazioni dettagliate sulle capacità e limitazioni dell'elaborazione PDF, vedi la documentazione del supporto PDF.
Considerazioni importanti per gli utenti dell'API Converse:
Per ulteriori dettagli sulle due modalità di elaborazione dei documenti e le loro limitazioni, fai riferimento alla guida del supporto PDF.
Claude Sonnet 4 e 4.5 supportano la finestra di contesto da 1M token su Amazon Bedrock.
La finestra di contesto da 1M token è attualmente in beta. Per utilizzare la finestra di contesto estesa, includi l'header beta context-1m-2025-08-07 nelle tue richieste API Bedrock.
A partire da Claude Sonnet 4.5 e tutti i modelli futuri, Amazon Bedrock offre due tipi di endpoint:
Gli endpoint regionali includono un premio di prezzo del 10% rispetto agli endpoint globali.
Questo si applica solo a Claude Sonnet 4.5 e ai modelli futuri. I modelli più vecchi (Claude Sonnet 4, Opus 4 e precedenti) mantengono le loro strutture di prezzo esistenti.
Endpoint globali (consigliato):
Endpoint regionali (CRIS):
Utilizzo di endpoint globali (predefinito per Sonnet 4.5 e 4):
Gli ID modello per Claude Sonnet 4.5 e 4 includono già il prefisso global.:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
message = client.messages.create(
model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}]
)Utilizzo di endpoint regionali (CRIS):
Per usare gli endpoint regionali, rimuovi il prefisso global. dall'ID modello:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
# Utilizzo dell'endpoint regionale US (CRIS)
message = client.messages.create(
model="anthropic.claude-sonnet-4-5-20250929-v1:0", # Nessun prefisso global.
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}]
)