Claude Platform Docs
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, 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 document direttamente in un messaggio assistant restituisce un errore 400.
      • L’invio di un blocco text con un array citations non vuoto in un messaggio user, direttamente o all’interno di un blocco search_result, restituisce un errore 400.
      • I parametri di richiesta temperature, top_p e top_k sono stati rimossi. Una richiesta che invia uno qualsiasi di essi restituisce un errore 400 su ogni modello.
    • 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 invece role_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 invece rbac_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 invece display_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 invece group.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 invece scope.workspace_id. Contiene l’ID del workspace della chiave, incluso il workspace predefinito. Una chiave valida per tutti i workspace non ha scope.workspace_id.
    • 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 invece actor.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 invece data.
  • 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.
    • Rimossi i valori legacy exception e truncated nelle risposte.
  • 2023-01-01: Rilascio iniziale.

Questa pagina ti è stata utile?