Utilizzo dell'API
Versioni
Quando si effettuano richieste API, è necessario inviare un header di richiesta anthropic-version
. Ad esempio, anthropic-version: 2023-06-01
. Se si utilizzano le nostre librerie client, questo viene gestito automaticamente.
Per qualsiasi versione dell’API, preserveremo:
- Parametri di input esistenti
- Parametri di output esistenti
Tuttavia, potremmo fare quanto segue:
- Aggiungere ulteriori input opzionali
- Aggiungere ulteriori valori all’output
- Modificare le condizioni per tipi di errore specifici
- Aggiungere nuove varianti a valori di output simili a enum (ad esempio, tipi di eventi di streaming)
In generale, se si utilizza l’API come documentato in questo riferimento, non interromperemo il vostro utilizzo.
Cronologia delle versioni
Raccomandiamo sempre di utilizzare la versione più recente dell’API quando possibile. Le versioni precedenti sono considerate deprecate e potrebbero non essere disponibili per i nuovi utenti.
2023-06-01
- Nuovo formato per gli eventi inviati dal server (SSE) di streaming:
- I completamenti sono incrementali. Ad esempio,
" Ciao"
," il mio"
," nome"
," è"
," Claude."
invece di" Ciao"
," Ciao il mio"
," Ciao il mio nome"
," Ciao il mio nome è"
," Ciao il mio nome è Claude."
. - Tutti gli eventi sono eventi denominati, anziché eventi solo dati.
- Rimosso l’evento non necessario
data: [DONE]
.
- I completamenti sono incrementali. Ad esempio,
- Rimossi i valori legacy
exception
etruncated
nelle risposte.
- Nuovo formato per gli eventi inviati dal server (SSE) di streaming:
2023-01-01
: Rilascio iniziale.