عوامی کام کی شناخت سے Rivya API کے کام کی حالت دیکھیں، قطار، پروسیسنگ، کامیابی یا ناکامی پڑھیں اور نتیجے کے لنکس استعمال کریں۔

غیر ہم وقت تخلیقی کام کی حالت دیکھنے کے لیے 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
}

سہولت کے لیے primaryUrl پہلا نتیجہ 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 واپس کرتا ہے۔

تخلیقی کام کی حالت