Перейти к содержимому

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.

Что внутри

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

Получите 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. Подробнее в разделе «Таймауты и повторы».

Что дальше

Те же модели доступны как MCP-инструмент chat — см. раздел MCP.