Clipia AI Gateway
Единый OpenAI-совместимый API к Claude, GPT, Gemini, DeepSeek и Grok с оплатой в рублях. Получите ключ и сделайте первый запрос за несколько минут.
Clipia AI Gateway — это единый OpenAI-совместимый API к флагманским языковым моделям: Claude, GPT, Gemini, DeepSeek и Grok. Один ключ, один контракт, оплата кредитами вашего аккаунта Clipia — без зарубежной карты. Это drop-in: если у вас уже есть код на 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 создавать не нужно: scope generate уже разрешает чат (подробнее — Аутентификация). Подходят и clipia_live_…, и clipia_test_….
Что внутри
Chat Completions
POST /v1/chat/completions — потоковый и обычный ответ, tool calling, structured outputs.
Модели и цены
Каталог моделей GET /v1/models и цены в рублях за 1M токенов.
LangChain
ChatOpenAI с нашим base_url — чат, инструменты и агенты.
Быстрый старт
Получите API-ключ
Создайте ключ в консоли разработчика → вкладка API-ключи. Полный ключ показывается один раз — сохраните его сразу. Это серверный секрет, не размещайте его в браузере или публичных репозиториях.
export CLIPIA_API_KEY=clipia_live_xxxxxxxxxxxxxxxxxxxxxxСделайте первый запрос
Используйте официальный openai SDK — поменяйте только base_url и ключ. Модель передаётся строкой (см. каталог).
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-4-8",
messages=[
{"role": "user", "content": "Привет! Назови три факта о Марсе."},
],
)
print(resp.choices[0].message.content)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-4-8",
messages: [
{ role: "user", content: "Привет! Назови три факта о Марсе." },
],
});
console.log(resp.choices[0].message.content);curl https://api.clipia.ai/v1/chat/completions \
-H "Authorization: Bearer $CLIPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-8",
"messages": [
{ "role": "user", "content": "Привет! Назови три факта о Марсе." }
]
}'Разберите ответ
Ответ — стандартный объект chat.completion. Текст лежит в choices[0].message.content, расход — в usage.
{
"id": "chatcmpl-3f9a1c7e2b41",
"object": "chat.completion",
"created": 1782300000,
"model": "claude-opus-4-8",
"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 — стоимость запроса в кредитах (списывается с баланса аккаунта). Тарификация — за токены ввода и вывода, см. цены.
Песочница без списания
Ключ с префиксом clipia_test_ работает в тестовом режиме — удобно отладить интеграцию до боевого запуска. См. Тестовый режим.
Совместимость
Gateway отвечает в формате OpenAI Chat Completions, поэтому работают клиенты, рассчитанные на OpenAI-контракт: openai SDK (Python и Node.js), LangChain, а также агентные инструменты, принимающие свой base_url. Поддерживаются потоковая передача (SSE с data: [DONE]), tool/function calling, structured outputs (response_format) и стандартный конверт ошибок OpenAI.
Что дальше
- Chat Completions — параметры, стриминг, инструменты, structured outputs.
- Модели и цены — каталог и тарифы.
- LangChain — чат и агенты.
- Аккаунт и лимиты —
GET /v1/key,GET /v1/generation, rate-limits. - Подробнее о продукте — на странице Clipia AI Gateway.
Те же модели доступны как MCP-инструмент chat — см. раздел MCP.