Riferimento APISupporto e configurazione
Versioni dell’API
Quando effettui richieste API, devi inviare un header di richiesta anthropic-version. Ad esempio, anthropic-version: 2026-10-21. Se stai utilizzando l’SDK client(si apre in una nuova scheda), imposta questo header per te.
Per qualsiasi versione dell’API, Anthropic preserva:
- I parametri di input esistenti
- I parametri di output esistenti
Tuttavia, Anthropic può fare quanto segue:
- Aggiungere ulteriori input opzionali
- Aggiungere ulteriori valori all’output
- Modificare le condizioni per specifici tipi di errore
- Aggiungere nuove varianti ai valori di output di tipo enum (ad esempio, i tipi di eventi di streaming)
In generale, se stai utilizzando l’API come documentato in questo riferimento, Anthropic non comprometterà il tuo utilizzo.
Cronologia delle versioni
Anthropic consiglia di utilizzare la versione più recente dell’API ogni volta che è possibile.
2026-10-21- Migrazione alla versione API 2026-10-21 mostra come effettuare l’aggiornamento.
- Disponibile sulla Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) e Microsoft Foundry. Su Amazon Bedrock, è disponibile per Claude 4.7 e i modelli successivi. Per i modelli Claude precedenti su Bedrock, mantieni la versione API che usi oggi.
- Messages API:
- Una richiesta che inserisce un blocco
documentdirettamente in un messaggioassistantrestituisce un errore 400. - L’invio di un blocco
textcon un arraycitationsnon vuoto in un messaggiouser, direttamente o all’interno di un bloccosearch_result, restituisce un errore 400. - I parametri di richiesta
temperature,top_petop_ksono stati rimossi. Una richiesta che invia uno qualsiasi di essi restituisce un errore 400 su ogni modello.
- Una richiesta che inserisce un blocco
- Admin API:
- I gruppi RBACAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non restituiscono più
roles. Usa invecerole_ids. - I membri dei gruppi RBACAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro), e la risposta alla rimozione di uno di essi, non restituiscono più
group_id. Usa invecerbac_group_id. - I ruoli RBACAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non restituiscono più
name. Usa invecedisplay_name. - Le voci dei “rate limit” (limiti di velocità) dell’organizzazioneAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) e del workspaceAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro), e la risposta all’impostazione dei limiti di velocità di un workspaceAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro), non restituiscono più
group_type. Usa invecegroup.type. - Le chiavi APIAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non restituiscono più
workspace_id. Usa invecescope.workspace_id. Contiene l’ID del workspace della chiave, incluso il workspace predefinito. Una chiave valida per tutti i workspace non hascope.workspace_id.
- I gruppi RBACAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non restituiscono più
- Claude Enterprise Analytics API:
- I report per utente di utilizzoAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) e di costoAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non contengono più
actor.email. Usa inveceactor.email_address. - La risposta dei riepiloghi delle attivitàAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non contiene più
summaries. Usa invecedata.
- I report per utente di utilizzoAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) e di costoAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro) non contengono più
2023-06-01- Nuovo formato per i “server-sent events” (eventi inviati dal server), o SSE, in streaming:
- I completamenti sono incrementali. Ad esempio,
" Hello"," my"," name"," is"," Claude."invece di" Hello"," Hello my"," Hello my name"," Hello my name is"," Hello my name is Claude.". - Tutti gli eventi sono eventi con nome, anziché eventi di soli dati.
- Rimosso l’evento
data: [DONE]non necessario.
- I completamenti sono incrementali. Ad esempio,
- Rimossi i valori legacy
exceptionetruncatednelle risposte.
- Nuovo formato per i “server-sent events” (eventi inviati dal server), o SSE, in streaming:
2023-01-01: Rilascio iniziale.
Questa pagina ti è stata utile?