Статус генерации
Опросите задачи генерации Rivya API по публичному ID задачи, читайте состояния queued, processing, succeeded и failed и используйте URL результатов.
Последняя проверка: 2026/05/10
Используйте GET /api/v1/generations/{taskId}, чтобы проверить асинхронную задачу генерации.
Конечная точка
GET https://rivya.ai/api/v1/generations/{taskId}Обязательный заголовок:
Authorization: Bearer rvya_sk_...Пример curl
curl https://rivya.ai/api/v1/generations/task_public_id \
-H "Authorization: Bearer rvya_sk_..."Значения статуса
Публичные значения статуса:
queued: задача принята, но еще не завершенаprocessing: генерация выполняетсяsucceeded: результат доступенfailed: задача завершилась ошибкой и может включать публичный объект ошибки
Успешный ответ
{
"id": "task_public_id",
"status": "succeeded",
"model": "z-image",
"reserved_credits": 1,
"final_credits": 1,
"created_at": "2026-05-10T00:00:00.000Z",
"updated_at": "2026-05-10T00:01:00.000Z",
"result": {
"primary_url": "https://media.example/result.png",
"urls": ["https://media.example/result.png"]
},
"error": null
}primary_url - первый URL результата для удобства. urls содержит список публичных URL результата, когда он доступен.
Ответ с ошибкой
{
"id": "task_public_id",
"status": "failed",
"model": "z-image",
"reserved_credits": 1,
"final_credits": 0,
"created_at": "2026-05-10T00:00:00.000Z",
"updated_at": "2026-05-10T00:01:00.000Z",
"result": null,
"error": {
"code": "generation_failed",
"message": "The generation failed."
}
}Рекомендации по опросу
Начните с короткой задержки, затем увеличивайте интервалы опроса. Избегайте плотных циклов.
Рекомендуемый шаблон:
- подождите 2-3 секунды после отправки
- опрашивайте обычные задачи каждые 5-10 секунд
- замедляйтесь для долгих видео- и аудиозадач
- прекращайте опрос, когда статус становится
succeededилиfailed
Граница владения
Задача должна принадлежать тому же аккаунту Rivya, который стоит за API-ключом. Если задача не найдена или не принадлежит аккаунту, конечная точка возвращает not_found.
Связанные страницы
Files API
Загружайте справочные изображения, видео или аудиофайлы для запросов генерации через Rivya API с проверками MIME, лимитами размера и токенами длительности.
Создание генерации
Отправляйте асинхронные задачи генерации Rivya API с model, prompt, params, Idempotency-Key и публичными полями ответа.