Inicio rápido

Quipua habla el mismo protocolo que OpenAI (/v1/chat/completions) y que Anthropic (/v1/messages). Si ya usas alguno de sus SDK, sólo cambias dos cosas: la URL base y la API key.

SDKURL base
OpenAI (Python, JavaScript y compatibles)https://api.quipua.com/v1
Anthropic (Python, TypeScript)https://api.quipua.com (el SDK añade /v1/messages)

Las keys de Quipua empiezan por ci_. En los ejemplos usamos ci_live_xxx: sustitúyela por la tuya y guárdala en una variable de entorno, nunca en el código.

1. Crea una key

En el panel, Keys → Nueva key. Cada key pertenece a un equipo: su consumo se descuenta del saldo de la empresa y cuenta para el presupuesto de ese equipo. La key se muestra una sola vez.

2. Haz tu primera llamada

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.quipua.com/v1",
    api_key=os.environ["QUIPUA_API_KEY"],  # ci_live_xxx
)

r = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Resume en una frase qué es un quipu."}],
    max_tokens=300,
)
print(r.choices[0].message.content)
// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.quipua.com/v1",
  apiKey: process.env.QUIPUA_API_KEY, // ci_live_xxx
});

const r = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Resume en una frase qué es un quipu." }],
  max_tokens: 300,
});
console.log(r.choices[0].message.content);
curl https://api.quipua.com/v1/chat/completions \
  -H "Authorization: Bearer $QUIPUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 300,
    "messages": [{"role": "user", "content": "Resume en una frase qué es un quipu."}]
  }'

Fija siempre un max_tokens realista. Cada petición reserva de tu saldo su coste máximo mientras está en curso; sin max_tokens se reservan 4.096 tokens de salida (o la salida máxima por defecto de tu equipo). Ver Saldo, presupuestos y límites.

Con el SDK de Anthropic

Si tu código usa la Messages API de Anthropic, usa /v1/messages. Fíjate en que la URL base no lleva /v1.

# pip install anthropic
import os
from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.quipua.com",
    api_key=os.environ["QUIPUA_API_KEY"],  # ci_live_xxx
)

r = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=300,
    messages=[{"role": "user", "content": "Hola"}],
)
print(r.content[0].text)
// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.quipua.com",
  apiKey: process.env.QUIPUA_API_KEY, // ci_live_xxx
});

const r = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 300,
  messages: [{ role: "user", content: "Hola" }],
});
console.log(r.content[0].text);
curl https://api.quipua.com/v1/messages \
  -H "x-api-key: $QUIPUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 300,
       "messages": [{"role": "user", "content": "Hola"}]}'

¿Qué modelo uso?

GET /v1/models lista los modelos que tu key puede usar (ver Modelos). Si tu equipo tiene configurado el modelo automático, puedes pedir "model": "auto" y Quipua elige según sus reglas (ver Modelo automático).

Frameworks

Cualquier herramienta que permita configurar un proveedor «compatible con OpenAI» funciona con Quipua. Estos son los más comunes.

Quipua implementa Chat Completions (/v1/chat/completions), no la Responses API de OpenAI (/v1/responses) ni embeddings. Si tu framework te deja elegir, usa Chat Completions.

# pip install langchain-openai
import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.quipua.com/v1",
    api_key=os.environ["QUIPUA_API_KEY"],
    model="claude-sonnet-5",
    max_tokens=500,
    # Cabeceras propias de Quipua (opcional)
    default_headers={"x-ci-ahorro": "conciso"},
)
print(llm.invoke("Dame tres ideas de nombre para una cafetería en Bogotá").content)
# pip install llama-index-llms-openai-like
import os
from llama_index.llms.openai_like import OpenAILike

llm = OpenAILike(
    api_base="https://api.quipua.com/v1",
    api_key=os.environ["QUIPUA_API_KEY"],
    model="claude-sonnet-5",
    is_chat_model=True,
    max_tokens=500,
)
print(llm.complete("Explica qué es el SPEI en dos frases"))
// npm install ai @ai-sdk/openai
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

const quipua = createOpenAI({
  baseURL: "https://api.quipua.com/v1",
  apiKey: process.env.QUIPUA_API_KEY,
});

// .chat() fuerza Chat Completions (Quipua no implementa la Responses API)
const { text } = await generateText({
  model: quipua.chat("claude-sonnet-5"),
  prompt: "Escribe un asunto de correo para una promoción de fin de mes",
  maxOutputTokens: 200,
});
console.log(text);
1. En n8n, Credentials → New → «OpenAI API».
2. API Key: tu key de Quipua (ci_live_xxx).
3. Base URL: https://api.quipua.com/v1
4. Guarda la credencial y úsala en el nodo «OpenAI Chat Model»
   (o en un AI Agent). En «Model» elige «By ID» y escribe el
   nombre del modelo, p. ej. claude-sonnet-5 o auto.

Siguientes pasos