ДокументацияУправление API ключами

Управление API ключами

API-ключ — это ваш доступ к Zenvy API. Все запросы авторизуются ключом вида sk-zenvy-....

Создание ключа

Войдите в личный кабинет на zenvy.su
Откройте раздел API-ключи
Нажмите Создать ключ и задайте понятное название (например, «прод», «локальная разработка», «Cursor»)
Скопируйте ключ сразу — полное значение показывается только один раз

Храните ключ в секрете

Ключ даёт доступ к вашему балансу. Не публикуйте его в git, логах и клиентском коде. Если ключ утёк — деактивируйте его и создайте новый.

Использование

Ключ передаётся в заголовке Authorization:

~/zenvy · zsh

curl https://api.zenvy.su/v1/chat/completions \
  -H "Authorization: Bearer sk-zenvy-..." \
  -H "Content-Type: application/json" \
  -d '{ "model": "gpt-4o", "messages": [{ "role": "user", "content": "Привет!" }] }'

Также поддерживается заголовок x-api-key:

~/zenvy · zsh

curl https://api.zenvy.su/v1/models \
  -H "x-api-key: sk-zenvy-..."

Рекомендации

Практика	Зачем
Отдельный ключ на каждое приложение	Утечку одного ключа можно закрыть, не трогая остальные
Ключ в переменной окружения	`ZENVY_API_KEY` вместо хардкода в коде
Регулярная ротация	Минимизирует риск от незамеченных утечек
Деактивация неиспользуемых ключей	Меньше точек входа — меньше рисков

Деактивация ключа

В разделе API-ключи нажмите на переключатель активности или удалите ключ. Запросы с деактивированным ключом сразу начнут получать 401 Unauthorized.

Частые ошибки

Ошибка	Причина
`401 Unauthorized`	Ключ не передан, неверный или деактивирован
`402 Payment Required`	Недостаточно средств на балансе
`403 Forbidden`	Аккаунт заблокирован

Подробнее: Обработка ошибок.