API-шлюз ИИ
Один токен для Claude, GPT, Gemini и Qwen с полной совместимостью официальных SDK каждого провайдера. Переход обычно требует изменения двух строк: base_url и api_key.
- Совместимость протоколов: прямые запросы через нативные протоколы OpenAI, Anthropic и Gemini без переработки
- Потоковая передача: полная поддержка SSE с задержкой первого токена на уровне прямого доступа
- Каталог моделей: доступные модели, окна контекста и возможности (изображения / инструменты / рассуждения)
- Использование и расчёты: оплата по токенам с разбивкой по ключам
Единый шлюз нескольких провайдеров с 3 точками входа официальных протоколов: Anthropic / OpenAI / Gemini. В любом из трёх форматов можно вызывать все модели шлюза. Оплата за использованные токены × официальный тариф × коэффициент ценовой группы, которую использует ваш ключ, без фиксированной ежемесячной платы.
Основная информация
- Authorization: Bearer sk-nc-... (Gemini также поддерживает x-goog-api-key / ?key=)
- После входа создайте ключ на странице «ИИ-сервисы → API-ключи»
- Официальный тариф USD/MTok × коэффициент ценовой группы; если у группы заданы непиковые часы, запросы в это время дополнительно умножаются на непиковый коэффициент. Предварительно списывается с баланса; потоковые вызовы рассчитываются асинхронно после завершения
- Поддерживаются вызовы GPT через SDK Anthropic и Claude через SDK OpenAI — шлюз автоматически преобразует протоколы
3 формата вызова
Anthropic /v1/messages
Использует протокол messages Claude; наиболее распространённый SDK (@anthropic-ai/sdk / anthropic для Python)
OpenAI /v1/chat/completions
Протокол OpenAI Chat Completions; поддерживает tools, потоковую передачу и мультимодальность
Gemini /v1beta/models/...
Нативный протокол Google Gemini; модель в пути определяет маршрутизацию
Уровни обслуживания и скорости
Шлюз всегда передаёт запросы на стандартном уровне и списывает стандартную цену; уровней со скидкой или ускорением нет:
- service_tier (flex / fast / priority и т. п.) удаляется из тела запросов в формате OpenAI
- speed (быстрый режим) удаляется из тела запросов в формате Anthropic
- Заголовок X-Service-Tier ни на что не влияет; запросы с ним обрабатываются на стандартном уровне
Коды ошибок
- 401 — API-ключ недействителен или отключён
- 402 insufficient_balance — Недостаточно средств: доступный баланс (за вычетом нерассчитанных расходов) ≤ 0 или не покрывает резерв для этого запроса (оценивается по лимитам контекста и вывода модели, плюс «максимум поисков × цена» при серверном веб-поиске); в сообщении об ошибке указаны нужный резерв и доступная сумма. Пополните и повторите. Когда доступный баланс опускается ниже $5, ответы содержат X-Tovanix-Balance-Low: 1 и X-Tovanix-Balance-Available (USD), чтобы можно было заранее предупредить
- 402 quota_exceeded — Достигнут месячный лимит расходов ключа; он обновится в следующем месяце. Лимит также можно изменить кнопкой «Изменить лимит» на странице «API-ключи» в консоли (нужно подтвердить личность)
- 403 group_unavailable — Ценовая группа, которую этот ключ использует для провайдера модели, отключена. Смените группу ключа на странице API-ключей; шлюз никогда сам не переводит запросы в другую группу
- 503 no_upstream_available — Для модели нет доступного маршрута в ценовой группе вашего ключа (маршруты отключены или временно на паузе). Повторите позже или, если у провайдера несколько групп, смените группу ключа на странице API-ключей
- 502 — Сервис модели временно недоступен или вернул ответ, который не удалось разобрать; повторите позже
Другие интерфейсы
Помимо чата, шлюз также предоставляет:
GET /v1/models
Список доступных для маршрутизации моделей (совместим с OpenAI; работает с models.list() SDK)
POST /v1/embeddings
Текстовые эмбеддинги (совместимы с OpenAI; передайте input, получите векторы; оплата за токены)
Примеры Python / Node.js
Полная песочница, тарифы и журналы вызовов доступны в Центр пользователя → ИИ-сервисы.
Часто задаваемые вопросы
Сколько кода меняется при переходе с API провайдера?
Обычно только base_url и api_key. Шлюз совместим с официальными SDK и протоколами без переработки: тела запросов, структуры ответов и потоковые форматы не меняются.
Поддерживается ли потоковая передача?
Да. Потоковая передача SSE полностью поддерживается. stream=true работает прямо из официальных SDK, а задержка первого токена соответствует прямому запросу к провайдеру.
Связанные страницы: ИИ-сервисы · Документация API · Решение «Глобальный ИИ»
Загрузка…