Présentation de l’API
Tous les endpoints exposés par la passerelle, le format qu’ils utilisent et les données qu’ils renvoient.
Trois points de terminaison. Deux formats de requête. Une clé.
| Méthode | Chemin | Format | Rôle |
|---|---|---|---|
| POST | /v1/messages | Anthropic Messages | Complétion de conversation, enveloppe Anthropic |
| POST | /v1/chat/completions | OpenAI Chat Completions | Complétion de conversation, enveloppe OpenAI |
| GET | /v1/models | Liste au format OpenAI | Identifiants des modèles que votre clé peut appeler |
Une description lisible par machine est publiée à l’adresse /openapi.json, et un résumé en texte brut de l’ensemble du site à l’adresse /llms.txt et /llms-full.txt.
Choisir un point de terminaison
Ils donnent accès aux mêmes modèles au même prix. Choisissez en fonction du format que votre client émet déjà — ne convertissez pas les formats vous-même.
| Endpoint | En-tête d’authentification | Structure de la réponse | Diffusion en continu |
|---|---|---|---|
/v1/messages | x-api-key ou Bearer | content[] tableau + usage | SSE, content_block_delta événements |
/v1/chat/completions | Bearer | choices[].message.content | SSE, choices[].delta.content fragments |
Les structures des flux diffèrent et ne sont pas interchangeables. Un client conçu pour
choices[].delta.content ne lira absolument rien dans un flux Messages. Voir Diffusion en continu.En-têtes communs
| En-tête | S’applique à | Remarques |
|---|---|---|
content-type: application/json | les deux requêtes POST | Obligatoire |
x-api-key | Messages | Style Anthropic |
Authorization: Bearer | les deux | Style OpenAI ; également accepté par Messages |
anthropic-version: 2023-06-01 | Messages | Défini automatiquement par les SDK Anthropic |
accept: text/event-stream | les deux | Défini par les SDK lorsque stream vaut true |