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.

HTTP
POST https://api.quipua.com/v1/chat/completions
Authorization: Bearer ci_live_xxx
Content-Type: application/json

Cuerpo de la petición

Admite los campos de la API de Chat Completions de OpenAI. Los más usados:

CampoTipoDescripción
modeltexto, obligatorioNombre del modelo (ver Modelos) o auto (ver Modelo automático).
messageslista, obligatorioMensajes con role (system, developer, user, assistant, tool) y content (texto o lista de partes).
max_tokens / max_completion_tokensenteroSalida máxima. Recomendado: determina cuánto saldo se reserva.
streambooleanoRespuesta por eventos (SSE). Ver Streaming.
temperature, top_p, stopParámetros de muestreo habituales.
tools, tool_choiceLlamada 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:

JSON
{
  "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.