Clipia AI Gateway — Clipia Docs

Clipia AI Gateway es una única API compatible con OpenAI para los modelos de lenguaje más avanzados: Claude, GPT, Gemini, DeepSeek y Grok. Una clave, un contrato, facturación con los créditos de su cuenta de Clipia. Si ya tiene código con el SDK openai o con LangChain, basta con apuntar base_url a https://api.clipia.ai/v1 y usar una clave de Clipia.

URL base

https://api.clipia.ai/v1: compatible con OpenAI Chat Completions. Autentíquese con una clave de API de Clipia normal: Authorization: Bearer clipia_.... Es la misma clave y el mismo saldo de créditos que usa para generar imágenes y vídeos. No necesita una clave aparte para el Gateway: el chat forma parte del permiso generate que tienen todas las claves (consulte Autenticación). Funcionan tanto clipia_live_… como clipia_test_…; una clave de prueba devuelve una respuesta predefinida que cuesta 0.

Qué incluye

Chat Completions

POST /v1/chat/completions: respuestas con y sin streaming, llamadas a herramientas, salidas estructuradas.

Modelos y precios

El catálogo GET /v1/models y los precios en dólares estadounidenses por 1M de tokens.

LangChain

ChatOpenAI con nuestro base_url: chat, herramientas y agentes.

Inicio rápido

Obtenga una clave de API

Cree una clave en la consola de desarrollador → pestaña Claves de API. La clave completa se muestra una sola vez: guárdela de inmediato. Es un secreto del lado del servidor; nunca la ponga en un navegador ni en un repositorio público.

export CLIPIA_KEY=clipia_live_xxxxxxxxxxxxxxxxxxxxxx

Haga su primera solicitud

Use el SDK oficial openai: cambie solo base_url y la clave. El modelo se pasa como una cadena (consulte el catálogo).

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CLIPIA_KEY"],
    base_url="https://api.clipia.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5-5",
    messages=[
        {"role": "user", "content": "Hi! Tell me three facts about Mars."},
    ],
)

print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CLIPIA_KEY,
  baseURL: "https://api.clipia.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-opus-5-5",
  messages: [
    { role: "user", content: "Hi! Tell me three facts about Mars." },
  ],
});

console.log(resp.choices[0].message.content);

curl https://api.clipia.ai/v1/chat/completions \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Hi! Tell me three facts about Mars." }
    ]
  }'

Lea la respuesta

La respuesta es un objeto chat.completion estándar. El texto está en choices[0].message.content y el consumo, en usage.

{
  "id": "chatcmpl-3f9a1c7e2b41",
  "object": "chat.completion",
  "created": 1782300000,
  "model": "claude-opus-5-5",
  "provider": "Clipia",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ...\n2. ...\n3. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 72,
    "total_tokens": 90,
    "cost": 0.05
  }
}

usage.cost es el coste de la solicitud en créditos (se cargan al saldo de la cuenta). La facturación es por token de entrada y de salida: consulte los precios.

Sandbox, sin cargos

Una clave con el prefijo clipia_test_ devuelve una respuesta predefinida con el mismo formato y no cobra nada, así que puede depurar el procesamiento de la respuesta antes de pasar a producción. Consulte Sandbox.

Compatibilidad

El gateway responde en el formato de OpenAI Chat Completions, por lo que los clientes creados para el contrato de OpenAI funcionan sin cambios: el SDK openai (Python y Node.js), LangChain y las herramientas de agentes que aceptan un base_url personalizado. Se admiten el streaming (SSE con data: [DONE]), las llamadas a herramientas y funciones, las salidas estructuradas (response_format) y el formato de error estándar de OpenAI.

Próximos pasos

Chat Completions: parámetros, streaming, herramientas, errores.
Modelos y precios: catálogo y tarifas.
LangChain: chat y agentes.
Clave y límites: GET /v1/key y límites de solicitudes.
Más información sobre el producto en la página de Clipia AI Gateway.

Los mismos modelos están disponibles como la herramienta MCP chat: consulte la sección MCP.