---
title: Clipia AI Gateway
description: Una única API compatible con OpenAI para Claude, GPT, Gemini, DeepSeek y Grok, que se paga con créditos de Clipia. Obtenga una clave y envíe su primera solicitud en un par de minutos.
icon: MessagesSquare
---

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.

<Callout type="info" title="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](/es/docs/getting-started/authentication#scopes)). Funcionan tanto `clipia_live_…` como `clipia_test_…`; una clave de prueba devuelve una respuesta predefinida que cuesta 0.
</Callout>

## Qué incluye

<Cards>
  <Card title="Chat Completions" href="/es/docs/llm-gateway/chat-completions">
    `POST /v1/chat/completions`: respuestas con y sin streaming, llamadas a herramientas, salidas estructuradas.
  </Card>
  <Card title="Modelos y precios" href="/es/docs/llm-gateway/models">
    El catálogo `GET /v1/models` y los precios en dólares estadounidenses por 1M de tokens.
  </Card>
  <Card title="LangChain" href="/es/docs/llm-gateway/langchain">
    `ChatOpenAI` con nuestro `base_url`: chat, herramientas y agentes.
  </Card>
</Cards>

## Inicio rápido

<Steps>

<Step>

### Obtenga una clave de API

Cree una clave en la [consola de desarrollador](/es/developer) → 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.

```bash
export CLIPIA_KEY=clipia_live_xxxxxxxxxxxxxxxxxxxxxx
```

</Step>

<Step>

### 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](/es/docs/llm-gateway/models)).

<Tabs items={['Python', 'Node.js', 'cURL']}>
<Tab value="Python">

```python
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)
```

</Tab>
<Tab value="Node.js">

```ts
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);
```

</Tab>
<Tab value="cURL">

```bash
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." }
    ]
  }'
```

</Tab>
</Tabs>

</Step>

<Step>

### 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`.

```json
{
  "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](/es/docs/llm-gateway/models).

</Step>

</Steps>

<Callout type="info" title="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](/es/docs/getting-started/sandbox).
</Callout>

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

<Callout type="info" title="Próximos pasos">
- [Chat Completions](/es/docs/llm-gateway/chat-completions): parámetros, streaming, herramientas, errores.
- [Modelos y precios](/es/docs/llm-gateway/models): catálogo y tarifas.
- [LangChain](/es/docs/llm-gateway/langchain): chat y agentes.
- [Clave y límites](/es/docs/llm-gateway/account): `GET /v1/key` y límites de solicitudes.
- Más información sobre el producto en la página de [Clipia AI Gateway](/es/ai-gateway).

Los mismos modelos están disponibles como la herramienta MCP `chat`: consulte la sección [MCP](/es/docs/mcp).
</Callout>