जनरेशन स्थिति

किसी असिंक्रोनस जनरेशन कार्य की स्थिति जांचने के लिए 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 होने पर जांच बंद करें

स्वामित्व सीमा

कार्य उसी Rivya खाते का होना चाहिए जिससे API कुंजी जुड़ी है। अगर कार्य नहीं मिलता या खाते के स्वामित्व में नहीं है, तो एंडपॉइंट not_found लौटाता है।

संबंधित पेज

• जनरेशन बनाएं

• API क्रेडिट

• Rivya में कार्य का जीवनचक्र

• असफल कार्य और क्रेडिट वापसी