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-5",
    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-5",
  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-5",
    "messages": [
      { "role": "user", "content": "Привет! Назови три факта о Марсе." }
    ]
  }'

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

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

{
  "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 — стоимость запроса в кредитах (списывается с баланса аккаунта). Тарификация — за токены ввода и вывода, см. цены.

Песочница без списания

Ключ с префиксом 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.