---
title: Clipia AI Gateway
description: Единый OpenAI-совместимый API к Claude, GPT, Gemini, DeepSeek и Grok с оплатой в рублях. Получите ключ и сделайте первый запрос за несколько минут.
icon: MessagesSquare
---

Clipia AI Gateway — это единый **OpenAI-совместимый** API к флагманским языковым моделям: Claude, GPT, Gemini, DeepSeek и Grok. Один ключ, один контракт, оплата кредитами вашего аккаунта Clipia — без зарубежной карты. Это drop-in: если у вас уже есть код на `openai` SDK или LangChain, достаточно сменить `base_url` на `https://api.clipia.ai/v1` и подставить ключ Clipia.

<Callout type="info" title="Базовый URL">
`https://api.clipia.ai/v1` — совместим с OpenAI Chat Completions. Авторизация — обычным API-ключом Clipia: `Authorization: Bearer clipia_...`. **Это тот же ключ и тот же баланс кредитов, что и для генерации фото/видео** — отдельный ключ для Gateway создавать не нужно: scope `generate` уже разрешает чат (подробнее — [Аутентификация](/docs/getting-started/authentication#scopes)). Подходят и `clipia_live_…`, и `clipia_test_…`.
</Callout>

## Что внутри

<Cards>
  <Card title="Chat Completions" href="/docs/llm-gateway/chat-completions">
    `POST /v1/chat/completions` — потоковый и обычный ответ, tool calling, structured outputs.
  </Card>
  <Card title="Модели и цены" href="/docs/llm-gateway/models">
    Каталог моделей `GET /v1/models` и цены в рублях за 1M токенов.
  </Card>
  <Card title="LangChain" href="/docs/llm-gateway/langchain">
    `ChatOpenAI` с нашим `base_url` — чат, инструменты и агенты.
  </Card>
</Cards>

## Быстрый старт

<Steps>

<Step>

### Получите API-ключ

Создайте ключ в [консоли разработчика](/developer) → вкладка **API-ключи**. Полный ключ показывается **один раз** — сохраните его сразу. Это серверный секрет, не размещайте его в браузере или публичных репозиториях.

```bash
export CLIPIA_API_KEY=clipia_live_xxxxxxxxxxxxxxxxxxxxxx
```

</Step>

<Step>

### Сделайте первый запрос

Используйте официальный `openai` SDK — поменяйте только `base_url` и ключ. Модель передаётся строкой (см. [каталог](/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_API_KEY"],
    base_url="https://api.clipia.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[
        {"role": "user", "content": "Привет! Назови три факта о Марсе."},
    ],
)

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

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

```ts
import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "claude-opus-5",
  messages: [
    { role: "user", content: "Привет! Назови три факта о Марсе." },
  ],
});

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

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

```bash
curl https://api.clipia.ai/v1/chat/completions \
  -H "Authorization: Bearer $CLIPIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      { "role": "user", "content": "Привет! Назови три факта о Марсе." }
    ]
  }'
```

</Tab>
</Tabs>

</Step>

<Step>

### Разберите ответ

Ответ — стандартный объект `chat.completion`. Текст лежит в `choices[0].message.content`, расход — в `usage`.

```json
{
  "id": "chatcmpl-3f9a1c7e2b41",
  "object": "chat.completion",
  "created": 1782300000,
  "model": "claude-opus-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` — стоимость запроса в **кредитах** (списывается с баланса аккаунта). Тарификация — за токены ввода и вывода, см. [цены](/docs/llm-gateway/models).

</Step>

</Steps>

<Callout type="info" title="Песочница без списания">
Ключ с префиксом `clipia_test_` работает в тестовом режиме — удобно отладить интеграцию до боевого запуска. См. [Тестовый режим](/docs/getting-started/sandbox).
</Callout>

## Совместимость

Gateway отвечает в формате OpenAI Chat Completions, поэтому работают клиенты, рассчитанные на OpenAI-контракт: `openai` SDK (Python и Node.js), LangChain, а также агентные инструменты, принимающие свой `base_url`. Поддерживаются потоковая передача (SSE с `data: [DONE]`), tool/function calling, structured outputs (`response_format`) и стандартный конверт ошибок OpenAI.

<Callout type="info" title="Что дальше">
- [Chat Completions](/docs/llm-gateway/chat-completions) — параметры, стриминг, инструменты, structured outputs.
- [Модели и цены](/docs/llm-gateway/models) — каталог и тарифы.
- [LangChain](/docs/llm-gateway/langchain) — чат и агенты.
- [Аккаунт и лимиты](/docs/llm-gateway/account) — `GET /v1/key`, `GET /v1/generation`, rate-limits.
- Подробнее о продукте — на странице [Clipia AI Gateway](/ai-gateway).

Те же модели доступны как MCP-инструмент `chat` — см. раздел [MCP](/docs/mcp).
</Callout>