AITUNNEL API

Всё, чего нет в OpenAI: баланс, расход, управление ключами, пресетами и платежами, каталог с ценами в рублях, провайдеры и бенчмарки.

Модели вызываются через OpenAI-совместимые методы: /chat/completions, /embeddings, /images/generations и остальные из справочника API. AITUNNEL API — это всё, чего в OpenAI нет: баланс, расход, каталог с ценами в рублях, бенчмарки и управление аккаунтом — API-ключи, пресеты, базы знаний, платежи.

Авторизация

Методы https://aitunnel.83.141.93.205.nip.io/__api/v1/aitunnel/… принимают три вида доступа:

Чем авторизоватьсяЧто открывает
API-ключ sk-aitunnel-…Своё: аккаунт, баланс, настройки ключа, его расход и запросы. Этим же ключом вызываются модели
Ключ управления sk-aitunnel-mgmt-…Весь аккаунт в пределах прав ключа: API-ключи, пресеты, базы знаний, платежи, расход по всем ключам. Модели не вызывает
Вход в кабинетТак с API работает сам кабинет. Принимается только со страниц aitunnel.83.141.93.205.nip.io: в своём коде используйте ключи

Методы https://aitunnel.83.141.93.205.nip.io/__api/public/aitunnel/… отвечают без авторизации: каталог и всё, что видно на сайте.

Оба ключа передаются одинаково: Authorization: Bearer sk-aitunnel-xxx или заголовок x-api-key. Какой ключ принимает метод и какое право нужно ключу управления, написано на странице метода; с другим ключом ответ — 403 с объяснением. Как создать API-ключ — в API-ключах, ключ управления — в ключах управления.

Если основной адрес недоступен из вашей сети, те же методы работают на зеркале: https://aitunnel.83.141.93.205.nip.io/__api-ru/v1.

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

# с ключом
curl https://aitunnel.83.141.93.205.nip.io/__api/v1/aitunnel/balance \
  -H "Authorization: Bearer sk-aitunnel-xxx"

# без ключа
curl https://aitunnel.83.141.93.205.nip.io/__api/public/aitunnel/models/chat

Методы

Аккаунт

Кто стоит за ключом, сколько денег на балансе и как настроен сам ключ. Нужен API-ключ; аккаунт и баланс отвечают и ключу управления.

Расход

Сколько потрачено и на что: сводка за период, список запросов и разбор одного. API-ключ видит только свои запросы, ключ управления с правом usage:read — весь аккаунт.

Управление

Всё, что делает кабинет: API-ключи, пресеты, базы знаний, платежи, документы, настройки. Нужен ключ управления с правом на метод.

Публичные данные

Каталог, провайдеры, бенчмарки и курс — то же, что показывает сайт. Ключ не нужен.

Общие правила

  • Формат. Запросы и ответы — JSON в UTF-8. Имена полей — в snake_case.
  • Деньги. Все суммы — в рублях, числом. Цены моделей — за миллион токенов.
  • Время. Моменты времени — строки ISO 8601 в UTC: 2026-11-14T09:30:00.000Z.
  • ID запроса. Каждый ответ несёт заголовок X-Request-Id. Назовите его поддержке — по нему запрос находится сразу.

Методы AITUNNEL API бесплатны и не расходуют баланс. Читать данные можно и при нулевом балансе.

Ошибки

Ошибка приходит с HTTP-статусом и телом одного вида:

JSON
{
  "error": {
    "code": 401,
    "type": "authentication_failed",
    "message": "Недействительный токен. Токен должен быть создан в нашем сервисе aitunnel.83.141.93.205.nip.io",
    "request_id": "req-0J9fQk2vXc8LrT1mNbZa4e"
  }
}

type — машинное имя ошибки, по нему удобно ветвить код; message — объяснение для человека. Все значения type и что с ними делать — в ошибках и отладке.

Лимиты

Методы с ключом, API или управления, ограничены так же, как запросы к моделям, — см. лимиты. Публичные методы ограничены по IP: 120 запросов в минуту к данным, которые приходится собирать заново; ответ из кэша лимит не расходует.