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

ModelloID modello Bedrock baseglobaluseujpapac
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0Copied!No
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0Copied!No
Claude Sonnet 3.7 anthropic.claude-3-7-sonnet-20250219-v1:0Copied!NoNo
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0Copied!NoNoNoNo
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0Copied!NoNoNoNo
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0Copied!NoNoNoNo
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0Copied!NoNo
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0Copied!NoNoNoNo
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0Copied!NoNo
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.
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 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.
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 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 versioni precedenti) mantengono le loro strutture di prezzo esistenti.

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