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

Все запросы к NexusAPI авторизуются через стандартный Bearer-токен.

Authorization: Bearer <ВАШ_API_KEY>

Где взять ключ

1. Зарегистрируйся на panel.nexusapi.dev (email + пароль)
2. Перейди в API ключи → Выпустить новый ключ
3. Скопируй полный секрет немедленно — он отображается ровно один раз. Дальше панель показывает только маскированный вид (e667...10b4)

Один аккаунт может иметь несколько ключей — удобно держать отдельный ключ под каждое приложение, отдельный для разработки и продакшена.

Безопасное хранение

Никогда не коммить ключ в репозиторий

GitHub и другие платформы сканируют коммиты на утёкшие секреты — если бот заметит ключ, он будет немедленно отозван. Любой утёкший ключ скомпрометирован и должен быть отозван вручную в панели.

Стандартный подход — env-переменные. Положи ключ в .env (добавь файл в .gitignore):

NEXUS_KEY=твой_секрет_здесь

И читай через переменную окружения:

Python

import os
key = os.environ["NEXUS_KEY"]

Node.js

const key = process.env.NEXUS_KEY;

Go

key := os.Getenv("NEXUS_KEY")

Что произойдёт без или с неверным ключом

Сценарий	Код
Заголовок Authorization не передан	401 Unauthorized
Ключ есть, но не существует в БД	401 Unauthorized
Ключ есть, но баланс ниже стоимости запроса	402 Payment Required
Ключ есть, но запрос не из allowed IP	403 Forbidden
Ключ есть, но модель не в allowed_models	403 Forbidden
Ключ есть, но превышен rate_limit_per_min	429 Too Many Requests

Ограничения на ключ

Для production-окружений рекомендуется привязать ключ к конкретным условиям. Настраивается в panel.nexusapi.dev → API ключи → Ограничения:

• Whitelist IP/CIDR — список адресов, с которых разрешён запрос. Например, IP твоего бэкенда: 203.0.113.5/32.
• Whitelist моделей — например, только veo-3-fast + nano-banana, если ключ для бота-генератора превью.
• Rate-limit в минуту — максимум запросов с этого ключа за 60 секунд.

Если попробовать с этого ключа дёрнуть модель не из списка или с IP не из разрешённых — получишь 403, баланс не списывается. При превышении rate-limit’а — 429.

Ротация и отзыв

Если есть подозрение, что ключ утёк — в панели нажми «Удалить» рядом с ним. Существующие задачи на этом ключе продолжат выполняться (рефанд при провале сработает на удалённый ключ), но новые /generate начнут давать 401.

После отзыва выпусти новый ключ, обнови env-переменную в проде, передеплой.