Utilizzo dell'API
Versioni
Quando si effettuano richieste API, è necessario inviare un’intestazione di richiesta anthropic-version. Per esempio, anthropic-version: 2023-06-01. Se stai utilizzando le nostre librerie client, questo viene gestito automaticamente per te.
Per qualsiasi versione API data, preserveremo:
- Parametri di input esistenti
- Parametri di output esistenti
Tuttavia, potremmo:
- Aggiungere ulteriori input opzionali
- Aggiungere ulteriori valori all’output
- Modificare le condizioni per specifici tipi di errore
- Aggiungere nuove varianti ai valori di tipo enum nell’output (per esempio, i tipi di eventi in streaming)
In generale, se stai utilizzando l’API come documentato in questo riferimento, non comprometteremo il tuo utilizzo.
Cronologia delle versioni
Raccomandiamo sempre di utilizzare l’ultima versione 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 server-sent (SSE):
- I completamenti sono incrementali. Per 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 nominati, invece di eventi solo dati.
- Rimosso l’evento
data: [DONE]non necessario.
- I completamenti sono incrementali. Per esempio,
- Rimossi i valori legacy
exceptionetruncatednelle risposte.
- Nuovo formato per gli eventi server-sent (SSE):
2023-01-01: Rilascio iniziale.