استطلع مهام توليد 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: فشلت المهمة وقد تتضمن كائن خطأ عاما

استجابة النجاح

{
  "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. إذا لم يتم العثور عليها أو لم تكن مملوكة للحساب، يعيد endpoint الخطأ not_found.

حالة التوليد