API-ключи
API-ключи начинаются с nb_ и имеют длину 48 символов. Создайте их в личном кабинете в разделе Профиль → API-ключи.
Создание ключа
- Войдите на neuralbox.top/web
- Перейдите в Профиль → API-ключи
- Нажмите Создать ключ
- Дайте ключу понятное название (например,
my-app-production)
- Скопируйте и сохраните ключ — он больше не будет показан
Использование ключа
Передавайте ключ в заголовке Authorization каждого запроса:
curl https://neuralbox.top/api/v2/generate \
-H "Authorization: Bearer nb_ВАШ_API_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5", "prompt": "Hello"}'
Форматы токенов
| Тип | Формат | Использование |
|---|
| API-ключ | nb_live_... | Серверные интеграции |
| JWT | eyJ... | Веб-платформа (автоматически) |
Управление ключами
Несколько ключей можно создавать для разных приложений или окружений:
# Список всех ключей
GET /api/v2/keys
# Создание нового ключа
POST /api/v2/keys
{"name": "my-production-app"}
# Отзыв ключа
DELETE /api/v2/keys/{key_id}
# Переименование ключа
PATCH /api/v2/keys/{key_id}
{"name": "new-name"}
Коды ошибок авторизации
| Код | Причина | Решение |
|---|
401 | Ключ отсутствует или неверен | Проверьте заголовок Authorization |
401 | Ключ отозван | Создайте новый ключ |
403 | Недостаточно прав | Убедитесь, что тариф VIP или Elite |
402 | Недостаточно токенов | Пополните баланс |
Безопасность
- Никогда не помещайте API-ключи в клиентский (браузерный) код
- Используйте переменные окружения:
NEURALBOX_API_KEY=nb_...
- Создавайте отдельные ключи для разных окружений (dev/staging/prod)
- Регулярно ротируйте ключи
import os
import requests
api_key = os.environ["NEURALBOX_API_KEY"]
response = requests.post(
"https://neuralbox.top/api/v2/generate",
headers={"Authorization": f"Bearer {api_key}"},
json={"model": "gpt-5", "prompt": "Hello"}
)
