Статус генерації
Опитуйте задачі генерації 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.
Пов'язані сторінки
Chat API
Використовуйте Rivya Chat API для повних або потокових SSE-відповідей, сесій, створених через API, вкладень зображень file_id і кредитного списання на основі токенів.
API кредити
Зрозумійте, як виклики Rivya API використовують кредити акаунта, перевірки балансу, зарезервовані кредити, повернення за невдалі задачі та усунення проблем із кредитами.