Chat completions
POST /v1/chat/completions es el endpoint principal, compatible con el de OpenAI. Sirve para cualquier modelo de chat del catálogo, incluidos los de Claude: Quipua traduce el formato al del proveedor.
POST https://api.quipua.com/v1/chat/completions
Authorization: Bearer ci_live_xxx
Content-Type: application/jsonCuerpo de la petición
Admite los campos de la API de Chat Completions de OpenAI. Los más usados:
| Campo | Tipo | Descripción |
|---|---|---|
model | texto, obligatorio | Nombre del modelo (ver Modelos) o auto (ver Modelo automático). |
messages | lista, obligatorio | Mensajes con role (system, developer, user, assistant, tool) y content (texto o lista de partes). |
max_tokens / max_completion_tokens | entero | Salida máxima. Recomendado: determina cuánto saldo se reserva. |
stream | booleano | Respuesta por eventos (SSE). Ver Streaming. |
temperature, top_p, stop | Parámetros de muestreo habituales. | |
tools, tool_choice | Llamada a herramientas (funciones), con el formato de OpenAI. |
El cuerpo debe ser un objeto JSON (si no, 400 invalid_json) y llevar model (si no, 400 missing_model). Los parámetros que no reconozca el modelo elegido los gestiona el proveedor.
Ejemplo
from openai import OpenAI
client = OpenAI(base_url="https://api.quipua.com/v1", api_key="ci_live_xxx")
r = client.chat.completions.create(
model="claude-sonnet-5",
max_tokens=500,
messages=[
{"role": "system", "content": "Eres el asistente de soporte de una tienda en línea."},
{"role": "user", "content": "¿Cómo pido una devolución?"},
],
)
print(r.choices[0].message.content)
print(r.usage)import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.quipua.com/v1", apiKey: "ci_live_xxx" });
const r = await client.chat.completions.create({
model: "claude-sonnet-5",
max_tokens: 500,
messages: [
{ role: "system", content: "Eres el asistente de soporte de una tienda en línea." },
{ role: "user", content: "¿Cómo pido una devolución?" },
],
});
console.log(r.choices[0].message.content, r.usage);curl https://api.quipua.com/v1/chat/completions \
-H "Authorization: Bearer ci_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 500,
"messages": [
{"role": "system", "content": "Eres el asistente de soporte de una tienda en línea."},
{"role": "user", "content": "¿Cómo pido una devolución?"}
]
}'Respuesta
La respuesta es la de OpenAI (object: "chat.completion"), con choices y usage:
{
"id": "chatcmpl-…",
"object": "chat.completion",
"model": "…",
"choices": [
{"index": 0, "message": {"role": "assistant", "content": "…"}, "finish_reason": "stop"}
],
"usage": {
"prompt_tokens": 1830,
"completion_tokens": 120,
"total_tokens": 1950,
"prompt_tokens_details": {"cached_tokens": 1500}
}
}En este formato prompt_tokens incluye los tokens leídos o escritos en la caché de prompts; el detalle va en prompt_tokens_details.cached_tokens y, con modelos de Claude, en cache_read_input_tokens y cache_creation_input_tokens. Ver Caché de prompts.
Además del cuerpo, la respuesta lleva cabeceras de Quipua, entre ellas x-request-id (identificador de la petición, útil para soporte) y x-ci-model-served (el modelo que respondió). Ver Cabeceras propias.
Herramientas (function calling)
tools y tool_choice se reenvían al modelo con el formato de OpenAI. Si usas auto y la petición lleva herramientas, Quipua sólo elige modelos que las admiten.
Imágenes
Puedes mandar imágenes como partes image_url del content a los modelos que las admiten. Con auto, una petición con imágenes sólo va a modelos con visión.
Lo que no está disponible
- Sólo modelos de chat: un modelo de otro tipo (imagen, audio, embeddings) responde
400 model_not_chat. - No hay
/v1/responses,/v1/embeddings,/v1/completions(sin chat) ni endpoints de audio o imagen.