তৈরির অবস্থা

অসমকালীন তৈরির কাজের অবস্থা দেখতে GET /api/v1/generations/{taskId} ব্যবহার করুন।

এন্ডপয়েন্ট

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 হলে আর অনুরোধ পাঠাবেন না

মালিকানার সীমা

কাজটি API কীটির একই Rivya অ্যাকাউন্টের হতে হবে। কাজ না পাওয়া গেলে বা অন্য অ্যাকাউন্টের হলে সংযোগবিন্দু not_found ফেরত দেয়।

সম্পর্কিত পৃষ্ঠা

• তৈরির অনুরোধ পাঠান

• API ক্রেডিট

• Rivya-তে কাজের জীবনচক্র

• ব্যর্থ কাজ ও ক্রেডিট ফেরত