Messages (formato Anthropic)
POST /v1/messages acepta el formato de la Messages API de Anthropic, para que el SDK de Anthropic (y las herramientas construidas sobre él) funcionen sin cambios. Saldo, presupuestos, límites, memoria, modelo automático y cabeceras funcionan igual que en Chat completions.
POST https://api.quipua.com/v1/messages
x-api-key: ci_live_xxx
Content-Type: application/jsonLa key puede ir en x-api-key (lo que manda el SDK de Anthropic) o en Authorization: Bearer.
En el SDK de Anthropic la URL base es https://api.quipua.com, sin /v1: el SDK añade /v1/messages.
Ejemplo
from anthropic import Anthropic
client = Anthropic(base_url="https://api.quipua.com", api_key="ci_live_xxx")
r = client.messages.create(
model="claude-sonnet-5",
max_tokens=500,
system="Responde siempre en español neutro.",
messages=[{"role": "user", "content": "¿Qué es un CFDI?"}],
)
print(r.content[0].text)
print(r.usage)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ baseURL: "https://api.quipua.com", apiKey: "ci_live_xxx" });
const r = await client.messages.create({
model: "claude-sonnet-5",
max_tokens: 500,
system: "Responde siempre en español neutro.",
messages: [{ role: "user", content: "¿Qué es un CFDI?" }],
});
console.log(r.content[0].text, r.usage);curl https://api.quipua.com/v1/messages \
-H "x-api-key: ci_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 500,
"system": "Responde siempre en español neutro.",
"messages": [{"role": "user", "content": "¿Qué es un CFDI?"}]
}'Cuerpo y respuesta
Los de la Messages API de Anthropic: model, max_tokens, messages, system (texto o lista de bloques), stream, temperature, stop_sequences, tools… La respuesta es un objeto message con content y usage.
En este formato usage.input_tokens no incluye la caché de prompts: lo leído de caché va en cache_read_input_tokens y lo escrito en cache_creation_input_tokens. Ver Caché de prompts.
Qué cambia respecto a Anthropic directo
- El nombre del modelo es el del catálogo de Quipua (por ejemplo
claude-sonnet-5), no el identificador de Anthropic con fecha. Consulta Modelos. - Puedes usar
"model": "auto"(ver Modelo automático). - Si tu empresa usa memoria compartida, se añade delante de tu
system(ver Memoria). - Sólo modelos de chat del catálogo de Quipua.