Кредиты API
Разберитесь, как вызовы Rivya API используют кредиты аккаунта, проверки баланса, зарезервированные кредиты, возвраты за неудачные задачи и диагностику кредитов.
Последняя проверка: 2026/05/10
Rivya API использует тот же кошелек кредитов аккаунта, что и Studio.
Используйте GET /api/v1/credits, чтобы прочитать текущий баланс аккаунта, которому принадлежит API-ключ.
Endpoint
GET https://rivya.ai/api/v1/creditsОбязательный header:
Authorization: Bearer rvya_sk_...Ответ
{
"current_credits": 123
}Биллинг генерации
Когда вы отправляете генерацию, Rivya проверяет, достаточно ли кредитов на аккаунте.
Для задач изображений, видео и аудио кредиты обычно резервируются или списываются при старте задачи. Ответ генерации включает:
reserved_creditsfinal_credits
final_credits может оставаться 0, пока задача все еще находится в очереди или выполняется.
Неудачные задачи
Если задача завершается ошибкой по существующим правилам отказов Rivya, обработка возврата следует той же продуктовой политике, что и в Studio.
Используйте статус генерации, чтобы подтвердить финальный статус, и неудачные задачи и возвраты кредитов, чтобы понять продуктовую модель отказов.
Распространенные ошибки кредитов
insufficient_credits: на аккаунте недостаточно кредитовapi_key_invalid: API-ключ не может определить аккаунтpublic_api_disabled: публичный API временно отключен
Связанные страницы
Chat API
Используйте Rivya Chat API для непотоковых или SSE-запросов, сессий, созданных через API, вложений изображений через file_id и расчета кредитов по использованию токенов.
Ошибки и лимиты API
Обрабатывайте публичные коды ошибок Rivya API, HTTP-статусы, лимиты частоты, конфликты идемпотентности и решения о повторах.