Аутентификация запросов

Разделы документации

API-ключ в заголовке Authorization

Все запросы к https://tokventa.tech/v1/* авторизуются ключом в формате OpenAI:

tokventa.tech/v1
Authorization: Bearer sk-…

Ключ создаётся в личном кабинете. Пробный ключ начинается с sk-trial и ограничен 100 000 токенов и 20 запросами в минуту; платные ключи работают без лимита токенов — пока на балансе есть деньги.

Доступные модели привязаны к ключу

У каждого ключа есть список разрешённых моделей (пробный — быстрые серии Flash и аналоги, платный — все 89 моделей каталога). Запрос к модели вне списка возвращает 403 с перечнем доступных. Актуальный список своего ключа можно получить запросом GET /v1/models.

Ошибки авторизации

КодКогдаСообщение
401Ключ не передан или неверныйНеверный или отсутствующий API-ключ. Заголовок: Authorization: Bearer sk-...
403Ключ отключёнКлюч отключён. Обратись к администратору.
403Модель недоступна ключуМодель "…" недоступна на твоём тарифе. Доступные: …
429Превышен лимит запросов в минутуПревышен лимит: N запросов/мин

Полный список ошибок: Коды ошибок API.

Безопасность

  • Не публикуйте ключ в клиентском коде (браузер, мобильное приложение) — запрашивайте ответы через свой бэкенд.
  • Скомпрометированный ключ можно удалить в кабинете и выпустить новый — баланс не пострадает.
  • Расходы по каждому ключу видны в кабинете: запросы, токены, списания.

Базовый URL API: https://tokventa.tech/v1 · Каталог моделей · Цены · Получить ключ