Saltar al contenido principal
POST
Usa este endpoint cuando tu aplicación, SDK o gateway espere el formato de solicitud y respuesta de OpenAI Chat Completions. Envía un payload estándar de Chat Completions con model y messages. Capriole AI resuelve los alias latest al ID de modelo del proveedor seleccionado antes del envío a upstream, reenvía campos compatibles como messages, tools, tool_choice, response_format y stream, y devuelve el JSON o el flujo SSE de upstream sin cambios, salvo la corrección de SSE para GLM y los comentarios de heartbeat que se describen abajo. En solicitudes streaming, Capriole AI establece stream_options.include_usage=true antes de reenviar para poder registrar el uso. En algunas respuestas SSE con model="zai/glm-5.3-flash", Capriole AI elimina únicamente el campo heredado vacío function_call={"name":"","arguments":""} de los deltas. Las llamadas reales o parciales, tool_calls, el texto y el uso se conservan. Esta excepción no afecta a respuestas sin streaming ni a otros modelos. POST /v1/chat/completions acepta openai-latest, claude-latest, google-latest y los IDs de modelo concretos públicos que devuelve GET /v1/models. Usa un alias latest para que Capriole AI elija nuestro modelo insignia recomendado para ese proveedor. Los alias latest son atajos de entrada. El uso se registra contra el modelo resuelto, mientras que el cuerpo de la respuesta conserva el comportamiento de nombres de modelo del endpoint compatible seleccionado.

Kimi K3.1 Pro

Kimi K3.1 Pro fija temperature en 1 y top_p en 0.95. Omite temperature, top_p, n, presence_penalty y frequency_penalty con este modelo, y envía las instrucciones con el rol system en lugar de developer.

Gemini 4 Carbon

google-latest se resuelve a google/gemini-4-carbon. Este endpoint reenvía el resto de tu solicitud sin cambios, así que Gemini 4 Carbon razona con el nivel predeterminado de Google, medium, que en nuestra prueba usó entre 3 y 4 veces los tokens de salida de Gemini 4 Argon con el mismo prompt. El reasoning_effort de OpenAI no cambia el nivel de razonamiento de Carbon. Para definirlo, envía el campo de Google con low, medium o high:
Con el SDK de OpenAI para Python, pasa extra_body={"extra_body": {"google": {"thinking_config": {"thinking_level": "low"}}}}. Google advierte que los prompts difíciles en Carbon pueden tardar varios minutos, así que transmítelos en streaming como se describe en Tareas largas; para esperar menos, establece thinking_level en low o usa google/gemini-4-argon.

Búsqueda web

Este endpoint no ofrece búsqueda web. Para los modelos Grok, una solicitud con un campo web_search_options o search_parameters distinto de null falla con HTTP 400:
Las herramientas de función que define tu cliente, incluso una llamada web_search, se reenvían sin cambios. Para buscar en la web con GPT o Grok, usa POST /v1/responses con "tools": [{"type": "web_search"}].

Tareas largas

Para tareas largas, como razonamiento extenso, establece "stream": true. Sin streaming, la conexión puede agotar el tiempo de espera después de unos 2 minutos. Mientras una solicitud con streaming espera al modelo, Capriole AI envía un comentario SSE : heartbeat cada 15 segundos, y las solicitudes google/* con streaming pueden esperar hasta 20 minutos el primer token. Si el modelo no ha respondido en 60 segundos, la respuesta 200 ya ha comenzado, así que un error de upstream posterior llega como un último evento SSE con un objeto error.

Autorizaciones

Authorization
string
header
requerido

Use an API key created in the Capriole AI page. Send it as Authorization: Bearer sk-....

Cuerpo

application/json
model
enum<string>
requerido

Public model identifier or latest alias returned by GET /v1/models

Opciones disponibles:
openai-latest,
openai/gpt-6.2-astra,
openai/gpt-6.2-sol,
openai/gpt-6-astra,
openai/gpt-6.1-sol,
openai/gpt-6-sol,
openai/gpt-6-luna,
openai/gpt-5.6-terra,
openai/gpt-5.6-luna,
claude-latest,
anthropic/claude-fable-5-1,
anthropic/claude-opus-5-5,
anthropic/claude-fable-5,
anthropic/claude-opus-5,
anthropic/claude-opus-4-8,
anthropic/claude-opus-4-7,
anthropic/claude-opus-4-6,
anthropic/claude-sonnet-4-6,
google-latest,
google/gemini-4-carbon,
google/gemini-4-argon,
google/gemini-3.8-flash,
xai/grok-4.7,
xai/grok-4.6,
xai/grok-4.5,
zai/glm-5.3-flash,
zai/glm-5.2,
moonshot/kimi-k3.1-pro,
moonshot/kimi-k3
messages
object[]
requerido

OpenAI-compatible conversation messages.

tools
object[]

OpenAI-compatible tool definitions.

tool_choice

OpenAI-compatible tool choice.

response_format
object

OpenAI-compatible response format.

stream
boolean
predeterminado:false

Stream the response as OpenAI-compatible server-sent events.

stream_options
object

OpenAI-compatible stream options. For streaming requests, Capriole AI sets include_usage=true before upstream dispatch for usage accounting.

Respuesta

OpenAI-compatible Chat Completions response or SSE stream. Response model fields follow the selected compatible endpoint and may differ from the input alias.

id
string
requerido
object
string
requerido
Ejemplo:

"chat.completion"

created
integer
requerido
model
string
requerido
choices
object[]
requerido
usage
object
Última modificación el 17 de noviembre de 2026