AI Gateway
Clipia AI Gateway
Единый OpenAI-совместимый API к Claude, GPT, Gemini, DeepSeek и Grok с оплатой кредитами Clipia. Получите ключ и сделайте первый запрос за пару минут.
Clipia AI Gateway — это единый OpenAI-совместимый API к флагманским языковым моделям: Claude, GPT, Gemini, DeepSeek и Grok. Один ключ, один контракт, оплата кредитами вашего аккаунта Clipia — без зарубежной карты. Если у вас уже есть код на openai SDK или LangChain, достаточно сменить base_url на https://api.clipia.ai/v1 и подставить ключ Clipia.
Базовый URL
https://api.clipia.ai/v1 — совместим с OpenAI Chat Completions. Авторизация — обычным API-ключом Clipia: Authorization: Bearer clipia_.... Это тот же ключ и тот же баланс кредитов, что и для генерации фото и видео. Отдельный ключ для Gateway не нужен: чат входит в право generate, которое есть у каждого ключа (подробнее — «Аутентификация»). Подходят и clipia_live_…, и clipia_test_…: тестовый ключ возвращает заготовленный ответ со стоимостью 0.
Что внутри
Chat Completions
POST /v1/chat/completions — потоковый и обычный ответ, вызов инструментов, структурированный вывод.
Модели и цены
Каталог моделей GET /v1/models и цены в рублях за 1M токенов.
LangChain
ChatOpenAI с нашим base_url — чат, инструменты и агенты.
Быстрый старт
Получите API-ключ
Создайте ключ в консоли разработчика → вкладка API-ключи. Полный ключ показывается один раз — сохраните его сразу. Это серверный секрет, не размещайте его в браузере или публичных репозиториях.
export CLIPIA_KEY=clipia_live_xxxxxxxxxxxxxxxxxxxxxxСделайте первый запрос
Используйте официальный openai SDK — поменяйте только base_url и ключ. Модель передаётся строкой (см. каталог).
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": "Привет! Назови три факта о Марсе."},
],
)
print(resp.choices[0].message.content)Разберите ответ
Ответ — стандартный объект chat.completion. Текст лежит в choices[0].message.content, расход — в 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,
"prompt_tokens_details": { "cached_tokens": 0 }
}
}В usage — расход токенов ввода и вывода. Стоимость в кредитах списывается с баланса аккаунта по тарифу модели (см. цены); узнать её по id ответа можно через GET /v1/generation — см. «Ключ и лимиты».
Песочница без списания
Ключ с префиксом clipia_test_ возвращает заготовленный ответ того же формата и ничего не списывает — так удобно отладить разбор ответа до боевого запуска. См. Тестовый режим.
Совместимость
Gateway отвечает в формате OpenAI Chat Completions, поэтому работают клиенты, рассчитанные на OpenAI-контракт: openai SDK (Python и Node.js), LangChain, а также агентные инструменты, принимающие свой base_url. Поддерживаются потоковая передача (SSE с data: [DONE]), вызов инструментов (tools), структурированный вывод (response_format) и стандартный конверт ошибок OpenAI.
Длинные ответы — в потоке
Долгий запрос без стриминга может получить 504: для длинных ответов и моделей с рассуждениями используйте stream: true, а для безопасных повторов — заголовок Idempotency-Key. Подробнее в разделе «Таймауты и повторы».
Что дальше
- Chat Completions — параметры, поток, инструменты, ошибки.
- Модели и цены — каталог и тарифы.
- LangChain — чат и агенты.
- Ключ и лимиты —
GET /v1/key, стоимость запроса поidи лимиты запросов. - Подробнее о продукте — на странице Clipia AI Gateway.
Те же модели доступны как MCP-инструмент chat — см. раздел MCP.
Версии и совместимость
Clipia API развивается в одной версии /v1 — какие изменения считаются совместимыми, что попадает в changelog, устаревшие поля и версии SDK.
Chat Completions
POST /v1/chat/completions — OpenAI-совместимый чат Clipia AI Gateway. Обычный и потоковый ответ, параметры, роли, вызов инструментов и ошибки.