Документация

С чего начать

Путь от регистрации до первого ответа модели — пять шагов:

1. 1. Зарегистрируйтесь и подтвердите email.
2. 2. Пополните баланс (PAYG — оплата по факту) или оформите подписку в кабинете.
3. 3. Создайте API-ключ в кабинете.
4. 4. Подставьте ключ и base_url в свой код (примеры ниже).
5. 5. Следите за расходом и квотой в кабинете.

Регистрация

Для регистрации нужны только email и пароль (минимум 8 символов); от спама защищает капча. Новый аккаунт заводится на PAYG (оплата по факту): доступ ко всем моделям, платите по токенам с баланса. Нужен предсказуемый бюджет — оформите подписку в кабинете.

Подтвердите email. После регистрации на указанный адрес приходит ссылка-подтверждение. Пока email не подтверждён, создание API-ключей недоступно — это защита аккаунта.

Тарифы и оплата

Тариф — это фиксированная подписка с месячной квотой токенови лимитами скорости. Квота обновляется каждый платёжный период. Управление — раздел «Подписка и оплата».

• Оплата — банковской картой через ЮKassa. Тариф/баланс активируются автоматически после подтверждения платежа (обычно в течение минуты).
• Автопродление. Подписка продлевается автоматически в конце периода; его можно отключить в кабинете — тогда по окончании периода подписка завершится, а доступ сохранится по балансу (оплата по факту).
• Баланс нужен только для перерасхода (overage) на тарифах с этой опцией — см. «Лимиты и квоты». Пополняется отдельно в том же разделе.
• Смена тарифа доступна в любой момент; неиспользованный остаток текущей подписки засчитывается при переходе.
• История платежей и списаний — в таблице транзакций в кабинете.

API-ключ

Ключ вида sk-aigate-… создаётся в кабинете (кнопка «Создать», можно задать название). Им вы и обращаетесь к API.

• Показывается один раз. Скопируйте ключ сразу — на сервере хранится только его хеш, повторно показать ключ нельзя.
• Можно завести несколько ключей (например, для разных приложений) и удалять их по отдельности.
• Удаление = мгновенный отзыв. Удалённый/скомпрометированный ключ сразу перестаёт работать на шлюзе — перевыпустите новый.

Первый запрос

Подставьте свой ключ и base_url в привычный клиент OpenAI — менять остальной код не нужно:

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-chat",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Эндпоинты

• POST /v1/chat/completions — основной: ответы в чате.
• GET /v1/models — список моделей, доступных вашему ключу.
• Стриминг — параметр stream: true (ответ приходит частями, Server-Sent Events), как в OpenAI.

API совместим с официальными OpenAI SDK (Python, Node.js и др.) и с любым инструментом, умеющим работать с OpenAI-совместимым endpoint.

Модели

Модель выбирается параметром model (например deepseek/deepseek-chat). Модели вашего тарифа оплачиваются из квоты; модели сверх тарифа доступны без апгрейда — оплачиваются по токенам с баланса. Если баланс исчерпан, сверх-тарифные модели ставятся на паузу (вернут 403), включённые в тариф работают.

Актуальный список с ценами и провайдерами — на странице «Модели»; программно доступные именно вашему ключу модели вернёт GET /v1/models.

Лимиты и квоты

• Месячная квота — включённый в тариф объём. Считаются токены запроса и ответа суммарно. Обновляется каждый платёжный период. Премиум-модели расходуют квоту быстрее: токен дорогой модели может списывать несколько единиц квоты (коэффициент зависит от модели) — на базовых моделях 1 токен = 1 единица.
• Запросов в минуту (RPM) и число параллельных запросов — ограничения скорости по тарифу (см. таблицу выше).
• Перерасход (overage) — на тарифах с этой опцией расход сверх квоты списывается с вашего баланса до жёсткого потолка (значение в колонке «Перерасход»). Дойдя до потолка, ключ останавливается, чтобы исключить неконтролируемые траты.
• Без overage (бюджетные тарифы) при исчерпании квоты включённые модели возвращают 429 до следующего периода; модели сверх тарифа продолжают работать за счёт баланса.
• Текущий расход и остаток квоты видны в кабинете в реальном времени.

Контроль расхода

В разделе «Расход» видны потреблённые токены и затраты по дням и по моделям. Сводка (тариф, токены за 30 дней, баланс) — на главной кабинета. Так можно заранее заметить приближение к квоте и при необходимости сменить тариф или пополнить баланс.

Защита данных

Запросы проходят через встроенную защиту (guardrail). Секреты (API-ключи, токены, приватные ключи) и номера банковских карт маскируются до отправки модели — в апстрим уходит [REDACTED], исходные данные модель не получает. Персональные данные (email, телефон, СНИЛС/ИНН и т.п.) фиксируются для аудита по 152-ФЗ, но текст запроса при этом не меняется.

Защиту можно отключить переключателем в кабинете (на свой риск — тогда запросы уходят провайдеру как есть). Персональные данные хранятся на серверах в РФ.

Безопасность ключа

• Храните ключ как пароль: не публикуйте в репозиториях, чатах, скриншотах.
• В коде передавайте ключ через переменные окружения, а не строкой в исходниках.
• Для разных приложений заводите разные ключи — скомпрометированный можно отозвать, не задев остальные.
• При утечке немедленно удалите ключ в кабинете и создайте новый.

Ошибки

Формат и коды — как в OpenAI API:

• 401 — неверный или отсутствующий ключ. Проверьте заголовок Authorization: Bearer sk-aigate-….
• 403 — модель недоступна ключу (сверх-тарифная при нулевом балансе). Пополните баланс или выберите модель из тарифа.
• 429 — превышен лимит запросов в минуту либо исчерпана квота/баланс. Снизьте темп или пополните/смените тариф.
• 400 — некорректный запрос (например, неизвестное имя модели или неверный формат тела).
• 5xx — временная проблема на стороне сервиса или провайдера модели; повторите запрос позже.

Вопросы и ответы