Journal des changements de l'API
Ce qui a changé dans le contrat de l'API, par date. Les évolutions du catalogue de modèles n'y figurent pas : elles ne demandent aucun changement de votre côté.
Ce journal ne retrace que les changements visibles depuis l'API : une route, un paramètre, un code d'erreur, une borne. Les évolutions du catalogue de modèles n'y figurent pas, parce qu'elles sont nombreuses et qu'elles ne demandent aucun changement de votre côté : la liste à jour est toujours celle que rend GET /v1/models.
Les nouveautés du produit, destinées aux utilisateurs, sont sur la page Nouveautés.
| Date | Changement |
|---|---|
| 2026-11-03 | POST /v1/messages prend en charge tout le format d'Anthropic : consigne système en blocs, tools et tool_choice, blocs tool_use et tool_result, images, temperature, max_tokens, top_p, stop_sequences, et un flux d'événements nommés. L'usage agent y fonctionne. Les avertissements « texte seul » de cette documentation sont retirés. |
| 2026-11-03 | Ouverture de POST /v1/messages/count_tokens : estimation du nombre de jetons d'entrée, sans appel à un modèle et sans consommation de crédits. |
| 2026-11-03 | Ouverture de GET /v1/netaix/usage : consommation, plafonds et restant de la clé qui appelle, pour le jour et pour le cycle. |
| 2026-11-03 | Une seule enveloppe d'erreur sur toutes les routes /v1 : {"error": {"message", "type", "code", "param"}}. Les anciennes formes (error dans detail, error en simple chaîne) disparaissent. Les routes au format Anthropic portent en plus "type": "error" au premier niveau. |
| 2026-11-03 | Le 429 de débit porte désormais un en-tête Retry-After et le code rate_limit_exceeded. Le 429 d'échecs d'authentification répétés porte le code too_many_auth_failures. |
| 2026-11-03 | Un seul refus de clé. Tous les refus d'authentification rendent le même 401, le même message et le même code invalid_api_key, quelle que soit la cause. Les refus qui rendaient un 403 pendant la vérification de la clé rendent eux aussi ce 401. |
| 2026-11-03 | Nouveau code 402 / insufficient_balance : solde prépayé épuisé sur un compte Développeur. |
| 2026-11-03 | top_p est désormais transmis au modèle sur POST /v1/chat/completions et POST /v1/messages, au lieu d'être accepté sans effet. |
| 2026-11-03 | Un appel sur un niveau netaix-* peut être rejoué une fois sur un modèle de niveau équivalent quand le fournisseur sollicité est en panne. Pas actif par défaut, jamais pour un modèle demandé par son nom, jamais sur un refus de contenu. |
| 2026-10-26 | Compte Développeur : la première recharge doit être payée avant le premier appel. Nouveau code 402 / topup_required. |
| 2026-10-04 | Les images envoyées dans la grammaire d'Anthropic sont reconnues sur POST /v1/chat/completions. Un format d'image non admis rend désormais un 422 explicite au lieu d'être ignoré. |
| 2026-10-03 | Le filtre des données sensibles s'applique aux quatre routes qui transmettent du texte. Nouveau code 451 / netaix_dlp_blocked. |
| 2026-09-30 | Ouverture de POST /v1/embeddings, avec ses bornes de volume. |
| 2026-09-18 | Les quatre niveaux netaix-fast, netaix-balanced, netaix-powerful et netaix-reasoning rejoignent netaix-auto et apparaissent dans GET /v1/models. |
| 2026-09-03 | Les sources d'une recherche web traversent la passerelle, dans un champ search_results au premier niveau d'un fragment de flux. |
| 2026-09-01 | Plafond de crédits journalier et de cycle par clé, alerte à 80 %, relevé de consommation par clé. Nouveaux codes 429 / key_daily_quota_exceeded et key_quota_exceeded. |
Cette page est tenue à la main à partir de ce qui est livré. Si vous constatez un écart entre ce qu'elle dit et ce que l'API fait, c'est l'API qui a raison, et nous voulons le savoir : écrivez-nous.