API-референс

Аутентификация

Все запросы авторизуются API-ключом в заголовке Authorization: Bearer sk-aigate-…. Ключ создаётся в личном кабинете. Базовый адрес — https://ai-gatewey.ru/v1.

Ответ в чате

Основной эндпоинт: принимает историю сообщений и возвращает ответ модели.

Параметры

Запрос

from openai import OpenAI

client = OpenAI(
    base_url="https://ai-gatewey.ru/v1",
    api_key="sk-aigate-ваш_ключ",
)

resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Ответ

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek/deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Привет! Чем могу помочь?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 8, "completion_tokens": 6, "total_tokens": 14 }
}

Список моделей

Возвращает модели, доступные вашему ключу (в поле data[].id). Полный каталог с ценами — на странице Модели.

Формат Anthropic

Тот же шлюз принимает запросы в формате Anthropic Messages — для инструментов, которые умеют работать только с ним (Claude Code, SDK anthropic). Ключ, тарификация, лимиты и каталог моделей — общие с /v1/chat/completions: в поле model указывается код из каталога, а не имя модели Anthropic.

export ANTHROPIC_BASE_URL=https://ai-gatewey.ru
export ANTHROPIC_AUTH_TOKEN=sk-aigate-…
export ANTHROPIC_MODEL=anthropic/claude-sonnet-5

claude

Доступны и остальные OpenAI-совместимые пути шлюза — /v1/responses (в том числе со встроенными инструментами) и /v1/images/generations; набор моделей для них определяется каталогом.

Модели, помеченные в каталоге как аудио, принимают звук на вход через тот же /v1/chat/completions — отдельного пути для них не требуется.

Коды ошибок

События (вебхуки)

Вместо опроса API можно подписаться на события — платёж зачислен, баланс на исходе, ключ упёрся в потолок или истёк, подписка продлена, счёт оплачен. Мы отправим POST с подписью HMAC-SHA256. Список событий, формат заголовков, пример проверки подписи и правила повторов — в разделе «Вебхуки». Адреса настраиваются в кабинете.