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à iscritto un account AWS e configurato l'accesso programmatico.

Installa e configura 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 Configura 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

Installa un SDK per accedere a Bedrock

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

Accesso a Bedrock

Sottoscrivi 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 Opus 4.6	anthropic.claude-opus-4-6-v1	Yes	Yes	Yes	Yes	Yes
Claude Sonnet 4.6	anthropic.claude-sonnet-4-6	Yes	Yes	Yes	Yes	No
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Yes

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

Elenca 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à almeno su una base mobile di 30 giorni per comprendere la tua attività e investigare qualsiasi potenziale uso improprio.

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 del 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, consulta la guida al supporto PDF.

Finestra di contesto da 1M token

Claude Opus 4.6, Sonnet 4.5 e Sonnet 4 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'intestazione 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 dei 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 (consigliati):

Forniscono la massima disponibilità e uptime
Instradano dinamicamente le richieste a regioni con capacità disponibile
Nessun premio di prezzo
Migliori per applicazioni dove 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 US, EU, 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 Opus 4.6, Sonnet 4.5 e Sonnet 4):

Gli ID modello per Claude Sonnet 4.5 e 4 includono già il prefisso global.:

Utilizzo di endpoint regionali (CRIS):

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

Risorse aggiuntive

Prezzo AWS Bedrock: aws.amazon.com/bedrock/pricing
Documentazione dei prezzi AWS: Guida ai prezzi di Bedrock
Post del blog AWS: Introducing 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-opus-4-6-v1",
    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-opus-4-6-v1",
    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-opus-4-6-v1",  # Nessun prefisso global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)