Cabeceras propias

Quipua añade algunas cabeceras propias, con prefijo x-ci-, en /v1/chat/completions y /v1/messages. Las de petición son opcionales: sin ellas, la petición se comporta como en OpenAI o Anthropic.

De petición

CabeceraValoresQué hace
x-ci-ahorroconciso, maximo (o normal)Modo ahorro. Añade delante del sistema una instrucción para que el modelo responda de forma directa (conciso) o con lo mínimo esencial (maximo), sin recortar código ni documentos. La salida es lo más caro de cada petición. Otro valor: 400 invalid_ahorro.
x-ci-memoryoffEsta petición no recibe la memoria de la empresa.

Modo ahorro

from openai import OpenAI

# Para todas las peticiones del cliente…
client = OpenAI(
    base_url="https://api.quipua.com/v1",
    api_key="ci_live_xxx",
    default_headers={"x-ci-ahorro": "conciso"},
)

# …o sólo para una
r = client.chat.completions.create(
    model="claude-sonnet-5",
    max_tokens=400,
    messages=[{"role": "user", "content": "¿Qué documentos pide el SAT para facturar?"}],
    extra_headers={"x-ci-ahorro": "maximo"},
)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.quipua.com/v1",
  apiKey: "ci_live_xxx",
  defaultHeaders: { "x-ci-ahorro": "conciso" },
});
curl https://api.quipua.com/v1/chat/completions \
  -H "Authorization: Bearer ci_live_xxx" -H "Content-Type: application/json" \
  -H "x-ci-ahorro: conciso" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 400, "messages": [{"role": "user", "content": "¿Qué documentos pide el SAT para facturar?"}]}'

La instrucción es siempre el mismo texto, así que forma parte del prefijo estable y aprovecha la caché de prompts. Cuenta como unos pocos tokens de entrada.

De respuesta

CabeceraCuándo apareceContenido
x-request-idSiempre que la petición llega al modeloIdentificador único de la petición. Inclúyelo si contactas con soporte.
x-ci-model-servedSiempre que la petición llega al modeloModelo que respondió y que se cobra.
x-ci-memory-tokensSi se añadió memoriaTokens de memoria añadidos (estimados).
x-ci-ahorroSi pediste conciso o maximoEl modo aplicado.
x-ci-requested-modelCon model: "auto"auto.
x-ci-route-reasonCon model: "auto"Regla del modelo automático que decidió.
x-ci-complexityCon auto y la regla de complejidad activaPuntuación 0–100.

Las respuestas de error de Quipua (saldo, presupuesto, key…) se generan antes de llamar al modelo y no llevan estas cabeceras.

Leer las cabeceras con los SDK

raw = client.chat.completions.with_raw_response.create(
    model="auto",
    max_tokens=100,
    messages=[{"role": "user", "content": "Hola"}],
)
print(raw.headers.get("x-ci-model-served"), raw.headers.get("x-ci-route-reason"))
completion = raw.parse()  # el objeto ChatCompletion de siempre
const { data, response } = await client.chat.completions
  .create({ model: "auto", max_tokens: 100, messages: [{ role: "user", content: "Hola" }] })
  .withResponse();
console.log(response.headers.get("x-ci-model-served"), response.headers.get("x-ci-route-reason"));
curl -i https://api.quipua.com/v1/chat/completions \
  -H "Authorization: Bearer ci_live_xxx" -H "Content-Type: application/json" \
  -d '{"model": "auto", "max_tokens": 100, "messages": [{"role": "user", "content": "Hola"}]}'