Tovanix
Tovanix

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 · Решение «Глобальный ИИ»

Загрузка…