Descripción general de la API
Todos los endpoints que expone la pasarela, qué formato utiliza cada uno y qué devuelve.
Tres endpoints. Dos formatos de solicitud. Una clave.
| Método | Ruta | Formato | Propósito |
|---|---|---|---|
| POST | /v1/messages | Messages de Anthropic | Completado de chat, estructura envolvente de Anthropic |
| POST | /v1/chat/completions | OpenAI Chat Completions | Generación de respuestas de chat, estructura de OpenAI |
| GET | /v1/models | Lista al estilo de OpenAI | Identificadores de modelos a los que puede llamar tu clave |
Se publica una descripción legible por máquinas en /openapi.json, y un resumen en texto plano de todo el sitio en /llms.txt y /llms-full.txt.
Elegir un endpoint
Dan acceso a los mismos modelos al mismo precio. Elige según el formato que ya genere tu cliente; no conviertas los formatos por tu cuenta.
| Endpoint | Cabecera de autenticación | Estructura de la respuesta | Transmisión en tiempo real |
|---|---|---|---|
/v1/messages | x-api-key o Bearer | content[] array + usage | SSE, content_block_delta eventos |
/v1/chat/completions | Bearer | choices[].message.content | SSE, choices[].delta.content fragmentos |
Las estructuras de streaming difieren y no son intercambiables. Un cliente escrito para
choices[].delta.content no leerá nada de un flujo de Messages. Consulta Transmisión en tiempo real.Cabeceras comunes
| Cabecera | Se aplica a | Notas |
|---|---|---|
content-type: application/json | ambas solicitudes POST | Obligatorio |
x-api-key | Messages | Estilo de Anthropic |
Authorization: Bearer | ambos | Estilo de OpenAI; también lo acepta Messages |
anthropic-version: 2023-06-01 | Messages | Los SDK de Anthropic la establecen automáticamente |
accept: text/event-stream | ambos | Los SDK la establecen cuando stream es true |