public task ID দিয়ে Rivya API generation jobs poll করুন, queued, processing, succeeded এবং failed states পড়ুন, এবং result URLs consume করুন।

asynchronous generation job check করতে GET /api/v1/generations/{taskId} ব্যবহার করুন।

Endpoint

GET https://rivya.ai/api/v1/generations/{taskId}

Required header:

Authorization: Bearer rvya_sk_...

curl Example

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

Status Values

Public status values:

queued: task accepted, complete নয়
processing: generation চলছে
succeeded: result available
failed: task failed এবং public error object থাকতে পারে

Succeeded Response

{
  "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 convenience-এর জন্য প্রথম result URL। available হলে urls public result URL list ধারণ করে।

Failed Response

{
  "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."
  }
}

Polling Guidance

short delay দিয়ে শুরু করুন, তারপর polling intervals বাড়ান। tight loops এড়িয়ে চলুন।

Recommended pattern:

submission-এর পরে 2-3 seconds wait করুন
normal jobs-এর জন্য প্রতি 5-10 seconds poll করুন
long video এবং audio jobs-এর জন্য slow down করুন
status succeeded বা failed হলে polling stop করুন

Ownership Boundary

task-টি API key-এর পেছনের একই Rivya account-এর হতে হবে। not found বা account-owned না হলে endpoint not_found return করে।

Generation Status