Claude su Amazon Bedrock

Amazon Bedrock (legacy)

Questa pagina copre l'integrazione di Amazon Bedrock disponibile oggi (le API InvokeModel e Converse con identificatori di modello con versione ARN e codifica di flussi di eventi AWS). Un'anteprima di ricerca di una nuova offerta gestita da AWS, con l'API Messages su /anthropic/v1/messages e streaming SSE, è documentata in Claude in Amazon Bedrock (anteprima di ricerca).

Chiamare Claude tramite Bedrock differisce leggermente da come chiameresti Claude quando usi gli SDK client di Anthropic. Questa guida ti guida attraverso il completamento di una chiamata API a Claude su Bedrock utilizzando uno degli SDK client di Anthropic.

Nota che questa guida presuppone che tu abbia già effettuato l'iscrizione a 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 utilizzando il comando AWS configure (vedi Configura l'AWS CLI) oppure trova le tue credenziali navigando a "Command line or programmatic access" nel tuo dashboard AWS e seguendo le istruzioni nel popup modale.
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 utilizzare direttamente un AWS SDK 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

Claude Opus 4.7 è disponibile su AWS tramite Claude in Amazon Bedrock, attualmente in anteprima di ricerca. Non è disponibile tramite il catalogo di modelli Bedrock standard documentato in questa pagina.

Modello	ID modello Bedrock base	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1	Sì	Sì	Sì	Sì	Sì
Claude Sonnet 4.6	anthropic.claude-sonnet-4-6	Sì	Sì	Sì	Sì	No
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Sì

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:

Effettuare richieste

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

Vedi gli SDK client per ulteriori dettagli e la documentazione ufficiale di Bedrock.

Autenticazione con token bearer

Puoi autenticarti con Bedrock utilizzando token bearer invece delle credenziali AWS. Questo è utile negli ambienti aziendali in cui i team hanno bisogno di accesso a Bedrock senza gestire credenziali AWS, ruoli IAM o autorizzazioni a livello di account.

L'autenticazione con token bearer è supportata negli SDK C#, Go e Java. Gli SDK PHP, Python, TypeScript e Ruby utilizzano solo la firma AWS SigV4.

L'approccio più semplice è impostare la variabile di ambiente AWS_BEARER_TOKEN_BEDROCK, che viene rilevata automaticamente dalla risoluzione delle credenziali fromEnv().

Per fornire un token a livello di programmazione:

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

L'attivazione di questo servizio non dà ad AWS o Anthropic alcun accesso ai tuoi contenuti.

Supporto delle funzionalità

Per tutte le funzionalità attualmente supportate su Bedrock, vedi Panoramica delle funzionalità API.

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 sui due modalità di elaborazione dei documenti e le loro limitazioni, fai riferimento alla guida del supporto PDF.

Finestra di contesto

Claude Opus 4.6 e Claude Sonnet 4.6 hanno una finestra di contesto di 1M token su Amazon Bedrock. Altri modelli Claude, inclusi Sonnet 4.5 e Sonnet 4 (deprecato), hanno una finestra di contesto di 200k token.

Amazon Bedrock limita i payload delle richieste a 20 MB. Quando invii documenti di grandi dimensioni o molte immagini, potresti raggiungere questo limite prima del limite di token.

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 (deprecato), Opus 4 (deprecato) e 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 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 (deprecato)):

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

Utilizzo di endpoint regionali (CRIS):

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

Claude Mythos Preview è un modello di anteprima di ricerca disponibile per i clienti invitati su Amazon Bedrock. Per ulteriori informazioni, vedi Project Glasswing.

Risorse aggiuntive

Prezzi 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

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentica fornendo le chiavi di seguito oppure usa 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, impostiamo il valore predefinito su 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)

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-east-1",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

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