Claude su Amazon Bedrock

La chiamata a Claude tramite Bedrock differisce leggermente da come chiameresti Claude quando utilizzi 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 AWS CLI

1. Installa una versione di AWS CLI alla versione 2.13.23 o successiva
2. Configura le tue credenziali AWS utilizzando il comando AWS configure (vedi Configurare 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.
3. Verifica che le tue credenziali funzionino:

aws sts get-caller-identity

Installare un SDK per accedere a Bedrock

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

pip install -U "anthropic[bedrock]"

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

Per ulteriori informazioni sugli ID modello regionali rispetto a quelli globali, vedi la sezione Endpoint globali vs regionali 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:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentica fornendo le chiavi di seguito oppure utilizza i provider di credenziali AWS predefiniti, come
    # utilizzando ~/.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, utilizziamo 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.

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 indagare su eventuali abusi.

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 sul 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, utilizza 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 Sonnet 4 e 4.5 supportano la finestra di contesto da 1M token su Amazon 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.

Quando utilizzare ciascuna opzione

Endpoint globali (consigliato):

• Forniscono la massima disponibilità e uptime
• Instradano dinamicamente le richieste a 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.:

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

Risorse aggiuntive

• Prezzo AWS Bedrock: aws.amazon.com/bedrock/pricing
• Documentazione sui 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