Статус генерації
Опитуйте задачі генерації Rivya API за публічним ID задачі, читайте стани queued, processing, succeeded і failed та використовуйте URL результатів.
Востаннє переглянуто 2026/05/10
Використовуйте GET /api/v1/generations/{taskId}, щоб перевірити асинхронну задачу генерації.
Endpoint
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-перевірками, лімітами розміру та duration tokens.
Створення генерації
Надсилайте асинхронні задачі генерації Rivya API з model, prompt, params, ключем ідемпотентності та публічними полями відповіді.