生成任务状态
通过公开任务 ID 轮询 Rivya API 生成任务，读取 queued、processing、succeeded、failed 状态和结果 URL。
最近审阅于 2026/05/10
使用 GET /api/v1/generations/{taskId} 查询异步生成任务。
Endpoint
GET https://rivya.ai/api/v1/generations/{taskId}必需 header：
Authorization: Bearer rvya_sk_...curl 示例
curl https://rivya.ai/api/v1/generations/task_public_id \
-H "Authorization: Bearer rvya_sk_..."状态值
公共状态值：
queued：任务已接受，尚未完成processing：生成正在进行succeeded：结果可用failed：任务失败，可能包含公共 error 对象
成功响应
{
"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后停止轮询
归属边界
任务必须属于 API Key 背后的同一个 Rivya 账户。如果不存在或不属于当前账户，接口返回 not_found。