API-ключи и оплата

Эта страница помогает подготовить доступ к API: создать ключ, подключить авторизацию и безопасно хранить ключи.

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

1. Откройте раздел API ключи в Braily.
2. Создайте новый API-ключ.
3. Сохраните секрет сразу после создания.

Секрет API-ключа показывается один раз. Если вы потеряли ключ или он мог попасть в чужие руки, отзовите его в настройках и создайте новый.

Использование API-ключа

API использует Bearer-токен. Передавайте ключ в заголовке Authorization в каждом запросе:

Authorization: Bearer <API_KEY>

Пример запроса:

curl "https://braily.ru/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A cinematic product photo of a white sneaker",
    "parameters": {
      "aspect_ratio": "1:1",
      "resolution": "1K"
    }
  }'

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

• Храните API-ключи в переменных окружения.
• Используйте разные ключи для разработки и продакшен окружения.
• Не публикуйте ключи в клиентском коде, мобильных приложениях и публичных репозиториях.
• Если ключ утек, сразу отзовите его и создайте новый.

API_KEY="br_..."

Оплата и токены

Каждая задача возвращает поле cost:

{
  "data": {
    "task_id": "task_123",
    "status": "CREATED",
    "cost": 10,
    "generated": []
  }
}

cost показывает, сколько кредитов было зарезервировано или списано для задачи. Стоимость зависит от выбранной модели и параметров запроса, например от resolution.

Если баланса не хватает, API вернет ошибку INSUFFICIENT_CREDITS:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits"
  }
}

В этом случае пополните баланс в Braily и повторите запрос.

Следующие шаги