Claude su Amazon Bedrock

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.

Installare e configurare l'AWS CLI

Installa una versione dell'AWS CLI alla versione 2.13.23 o successiva
Configura le tue credenziali AWS usando il comando AWS configure (vedi Configurare l'AWS CLI) oppure trova le tue credenziali navigando a "Command line or programmatic access" all'interno della tua dashboard AWS e seguendo le indicazioni nel modal popup.
Verifica che le tue credenziali funzionino:

Shell

aws sts get-caller-identity

Installare un SDK per accedere a Bedrock

Gli SDK client di Anthropic supportano Bedrock. Puoi anche usare direttamente un SDK AWS come boto3.

pip install -U "anthropic[bedrock]"

Accesso a Bedrock

Sottoscrivere i modelli Anthropic

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.

ID modello API

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

Per ulteriori informazioni sugli ID modello regionali rispetto a quelli globali, vedi la sezione Endpoint globali vs regionali di seguito.

Elencare i modelli disponibili

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"

Effettuare richieste

I seguenti esempi mostrano come generare testo da Claude su Bedrock:

Vedi i nostri SDK client per ulteriori dettagli, e la documentazione ufficiale di Bedrock qui.

Registrazione dell'attività

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.

Supporto delle funzionalità

Puoi trovare tutte le funzionalità attualmente supportate su Bedrock qui.

Supporto PDF su Bedrock

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:

L'analisi visiva dei PDF (grafici, immagini, layout) richiede l'abilitazione delle citazioni
Senza citazioni, è disponibile solo l'estrazione di testo di base
Per il controllo completo senza citazioni forzate, usa l'API InvokeModel

Per ulteriori dettagli sulle due modalità di elaborazione dei documenti e le loro limitazioni, fai riferimento alla guida del supporto PDF.

Finestra di contesto da 1M token

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.

Endpoint globali vs regionali

A partire da Claude Sonnet 4.5 e tutti i modelli futuri, Amazon Bedrock offre due tipi di endpoint:

Endpoint globali: Instradamento dinamico per la massima disponibilità
Endpoint regionali: Instradamento dati garantito attraverso regioni geografiche specifiche

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.

Quando usare ogni opzione

Endpoint globali (consigliato):

Forniscono la massima disponibilità e tempo di attività
Instradano dinamicamente le richieste alle regioni con capacità disponibile
Nessun premio di prezzo
Migliore per le applicazioni in cui la residenza dei dati è flessibile

Endpoint regionali (CRIS):

Instradano il traffico attraverso regioni geografiche specifiche
Richiesti per i requisiti di residenza dei dati e conformità
Disponibili per Stati Uniti, UE, Giappone e Australia
Il premio di prezzo del 10% riflette i costi dell'infrastruttura per la capacità regionale dedicata

Implementazione

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.:

Utilizzo di endpoint regionali (CRIS):

Per usare gli endpoint regionali, rimuovi il prefisso global. dall'ID modello:

Risorse aggiuntive

Prezzi AWS Bedrock: aws.amazon.com/bedrock/pricing
Documentazione dei prezzi AWS: Guida ai prezzi di Bedrock
Post del blog AWS: Introduzione a Claude Sonnet 4.5 in Amazon Bedrock
Dettagli sui prezzi di Anthropic: Documentazione sui prezzi

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)

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"}]
)

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"}]
)