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.

HTTP
POST https://api.quipua.com/v1/messages
x-api-key: ci_live_xxx
Content-Type: application/json

La 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.