Передача API-ключа
Authorization: Bearer <GENSTA_API_KEY>GET /v1/models доступен без авторизации. Для генераций нужен действующий ключ. Загрузка файлов должна быть включена для проекта.
Права ключа
| Scope | Что разрешает |
|---|---|
| generations:write | Создавать генерации и управлять загрузкой медиа |
| generations:read | Читать статусы генераций и медиа |
Если ключ отсутствует или недействителен, API вернёт 401 authentication_required. Если у ключа нет нужного права — 403 forbidden.
Безопасность ключа
- Храните ключ в хранилище секретов или переменной окружения.
- Вызывайте Gensta из серверной части приложения.
- Не добавляйте ключ в сайт, мини-эпп или iOS/Android приложение.
- Не публикуйте тексты запросов и ссылки на медиа.
Управление ключами
Создавайте и отзывайте ключи на platform.gensta.ai. Новый ключ показывается один раз. Перед отзывом рабочего ключа сначала создайте замену.
Актуальный баланс
/v1/balanceBearer key · generations:read{
"currency": "USD",
"available": "42.500000",
"held": "1.250000"
}available можно потратить на новые генерации, а held временно зарезервирован активными генерациями. Ответы создания и статуса показывают резерв или итоговое списание конкретной генерации в billing. Текущий баланс не вкладывается в каждый такой ответ, потому что параллельные запросы могут сразу его изменить. Для свежего значения вызывайте GET /v1/balance.