透過公開 task ID 輪詢 Rivya API 生成任務，讀取 queued、processing、succeeded 和 failed 狀態，並使用結果 URL。

使用 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 object

成功回應

{
  "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。

生成狀態