Utilisation de l'API
Versions
Lors des requêtes API, vous devez envoyer un en-tête de requête anthropic-version
. Par exemple, anthropic-version: 2023-06-01
. Si vous utilisez nos bibliothèques client, cela est géré automatiquement pour vous.
Pour toute version d’API donnée, nous préserverons :
- Les paramètres d’entrée existants
- Les paramètres de sortie existants
Cependant, nous pouvons effectuer les actions suivantes :
- Ajouter des entrées optionnelles supplémentaires
- Ajouter des valeurs supplémentaires à la sortie
- Modifier les conditions pour des types d’erreurs spécifiques
- Ajouter de nouvelles variantes aux valeurs de type énumération en sortie (par exemple, les types d’événements de streaming)
En général, si vous utilisez l’API comme documenté dans cette référence, nous ne perturberons pas votre utilisation.
Historique des versions
Nous recommandons toujours d’utiliser la dernière version de l’API dans la mesure du possible. Les versions précédentes sont considérées comme obsolètes et peuvent être indisponibles pour les nouveaux utilisateurs.
2023-06-01
- Nouveau format pour les événements envoyés par le serveur (SSE) :
- Les complétions sont incrémentales. Par exemple,
" Hello"
," my"
," name"
," is"
," Claude."
au lieu de" Hello"
," Hello my"
," Hello my name"
," Hello my name is"
," Hello my name is Claude."
. - Tous les événements sont des événements nommés, plutôt que des événements de données uniquement.
- Suppression de l’événement
data: [DONE]
inutile.
- Les complétions sont incrémentales. Par exemple,
- Suppression des valeurs héritées
exception
ettruncated
dans les réponses.
- Nouveau format pour les événements envoyés par le serveur (SSE) :
2023-01-01
: Version initiale.