Visnea

Visnea API

Аутентификация

Каждый запрос к /v1 авторизуется API-ключом формата sk-visnea-…. Один ключ покрывает генерацию, чат и плагины для редакторов — всё на одном балансе.

API-ключи

Ключи создаются в кабинете: раздел «Аккаунт» или «Плагины» → карточка «API-ключи». Секрет показывается один раз при создании — дальше виден только префикс.

  • Ключей может быть несколько — по одному на интеграцию (CLI, бэкенд, плагин).
  • Любой ключ можно отозвать в кабинете; отозванный ключ перестаёт работать сразу.
  • Ключ наследует права и баланс вашего аккаунта — отдельных «скоупов» нет.
Создать или отозвать ключ: кабинет Visnea.

Ответ без ключа

Запрос без ключа (или с отозванным ключом) вернёт 401 с конвертом ошибки:

401 · response
{  "error": "auth required",  "code": "unauthorized"}

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

  • Храните ключ на сервере (переменная окружения, секрет-хранилище). Не вшивайте его в клиентский код, мобильные приложения и репозитории.
  • Скомпрометированный ключ немедленно отзовите в кабинете и создайте новый.
  • Для разных сред (dev/prod) используйте разные ключи — так проще ротировать.