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
| Cabecera | Valores | Qué hace |
|---|---|---|
x-ci-ahorro | conciso, 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-memory | off | Esta 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
| Cabecera | Cuándo aparece | Contenido |
|---|---|---|
x-request-id | Siempre que la petición llega al modelo | Identificador único de la petición. Inclúyelo si contactas con soporte. |
x-ci-model-served | Siempre que la petición llega al modelo | Modelo que respondió y que se cobra. |
x-ci-memory-tokens | Si se añadió memoria | Tokens de memoria añadidos (estimados). |
x-ci-ahorro | Si pediste conciso o maximo | El modo aplicado. |
x-ci-requested-model | Con model: "auto" | auto. |
x-ci-route-reason | Con model: "auto" | Regla del modelo automático que decidió. |
x-ci-complexity | Con auto y la regla de complejidad activa | Puntuació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 siempreconst { 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"}]}'