التوثيق

مرجع API

الحصول على نتائج الفيديو

GET/v1/videos/{task_id}/result

تُعاد النتيجة عندما تكون جاهزة فقط. تتطلب بعض النتائج وصولًا موثقًا عبر authenticated_content/content_path. لحفظ الملفات حالة مستقلة وقد تنتهي روابط التنزيل المؤقتة.

المصادقة والصلاحيات

استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.

Authorization: Bearer $GLOOP_API_KEY

آليات المصادقة: BearerAuth

الطلب

معاملات المسار

  • task_idstringمطلوب

    المعرّف العام لمهمة أُنشئت بالمفتاح نفسه.

الاستجابات والأخطاء

HTTP 200

نجح الطلب.

application/json

النوع
object
الحقول المطلوبة
idmodelstatuscreated_at
  • updated_atintegerاختياري

    آخر تحديث بثواني Unix.

  • retentionstringاختياري

    سياسة الاحتفاظ بنتائج المهمة؛ persistent يعني مساحة العمل الدائمة.

  • inputobjectاختياري

    مدخلات المهمة الأصلية أو مدخلات عقد الأداة.

    الحقول الفرعية لـ input (14)
    • modestringاختياري

      مطلوب في persistent.

      القيم المعدودة
      ["text_to_video","image_to_video"]
    • retentionstringاختياري

      يستخدم persistent مساحة العمل الدائمة؛ وحذفه يعني مهمة عادية.

    • quote_idstringاختياري

      يتطلب طلب persistent الجديد تأكيد عرض صالح من video-quotes أولًا.

    • start_frameobjectاختياري

      مطلوب لتحويل الصورة إلى فيديو في persistent، بملف مستضاف للمفتاح نفسه؛ ممنوع لتحويل النص إلى فيديو.

      الحقول الفرعية لـ start_frame (1)
      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

      فرع allOf رقم 1

      النوع: object

      المطلوب في هذا الفرع: file_id

      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • end_frameobjectاختياري

      إطار أخير اختياري في persistent إذا كانت الإمكانية تدعمه.

      الحقول الفرعية لـ end_frame (1)
      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

      فرع allOf رقم 1

      النوع: object

      المطلوب في هذا الفرع: file_id

      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • webhook_endpoint_idstringاختياري

      يمكن للمهام العادية الإشارة إلى جهة استقبال مُعدّة في وحدة التحكم؛ ويُحظر ذلك للمهام persistent.

    • modelstringمطلوب

      معرّف نموذج عام من دليل المفتاح الحالي؛ ولا يضمن استمرار توفر نموذج خدمة سابق.

    • promptstringمطلوب

      توجيه التوليد.

      الحد الأدنى للطول
      1
      الحد الأقصى للطول
      2500
    • durationintegerاختياري

      مدة بالثواني خاصة بالنموذج. استخدم التركيبة الكاملة من video-models mode.presets، لا حاصل ضرب ديكارتي. لا يدعم Wan Turbo هذا الحقل؛ ولا توجد قيمة افتراضية موحدة.

    • image_urlstringاختياري

      إطار أول HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

    • end_image_urlstringاختياري

      إطار أخير HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

    • resolutionstringاختياري

      قيمة الدقة في الإعداد المسبق للنموذج.

    • aspect_ratiostringاختياري

      قيمة نسبة العرض إلى الارتفاع في الإعداد المسبق للنموذج.

    • generate_audiobooleanاختيارييسمح بـ null

      يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

    فرع allOf رقم 1

    النوع: object

    المطلوب في هذا الفرع: model, prompt

    خصائص إضافية: false

    • modestringاختياري

      مطلوب في persistent.

      القيم المعدودة
      ["text_to_video","image_to_video"]
    • retentionstringاختياري

      يستخدم persistent مساحة العمل الدائمة؛ وحذفه يعني مهمة عادية.

    • quote_idstringاختياري

      يتطلب طلب persistent الجديد تأكيد عرض صالح من video-quotes أولًا.

    • start_frameobjectاختياري

      مطلوب لتحويل الصورة إلى فيديو في persistent، بملف مستضاف للمفتاح نفسه؛ ممنوع لتحويل النص إلى فيديو.

      الحقول الفرعية لـ start_frame (1)
      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

      فرع allOf رقم 1

      النوع: object

      المطلوب في هذا الفرع: file_id

      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • end_frameobjectاختياري

      إطار أخير اختياري في persistent إذا كانت الإمكانية تدعمه.

      الحقول الفرعية لـ end_frame (1)
      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

      فرع allOf رقم 1

      النوع: object

      المطلوب في هذا الفرع: file_id

      • file_idstringمطلوب

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • webhook_endpoint_idstringاختياري

      يمكن للمهام العادية الإشارة إلى جهة استقبال مُعدّة في وحدة التحكم؛ ويُحظر ذلك للمهام persistent.

    • modelstringمطلوب

      معرّف نموذج عام من دليل المفتاح الحالي؛ ولا يضمن استمرار توفر نموذج خدمة سابق.

    • promptstringمطلوب

      توجيه التوليد.

      الحد الأدنى للطول
      1
      الحد الأقصى للطول
      2500
    • durationintegerاختياري

      مدة بالثواني خاصة بالنموذج. استخدم التركيبة الكاملة من video-models mode.presets، لا حاصل ضرب ديكارتي. لا يدعم Wan Turbo هذا الحقل؛ ولا توجد قيمة افتراضية موحدة.

    • image_urlstringاختياري

      إطار أول HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

    • end_image_urlstringاختياري

      إطار أخير HTTPS حسب النموذج للمهام العادية فقط؛ ممنوع في persistent.

    • resolutionstringاختياري

      قيمة الدقة في الإعداد المسبق للنموذج.

    • aspect_ratiostringاختياري

      قيمة نسبة العرض إلى الارتفاع في الإعداد المسبق للنموذج.

    • generate_audiobooleanاختيارييسمح بـ null

      يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

  • billingobjectاختياري

    حالة الفوترة المستقلة؛ لا تستبدلها بحالة التوليد.

    الحقول الفرعية لـ billing (7)
    • currencystringمطلوب

      عملة عرض السعر/الفوترة.

    • error_codestringاختياري

      رمز خطأ عام يمكن استخدامه في منطق التفرّع.

    • statusstringمطلوب

      حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

    • reserved_quotaintegerمطلوب

      الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

    • final_quotaintegerمطلوبيسمح بـ null

      التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

    • reserved_amountstringمطلوب

      الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.

    • final_amountstringمطلوبيسمح بـ null

      الرسوم النهائية كسلسلة نصية؛ تعني null عدم التسوية بعد.

    فرع allOf رقم 1

    النوع: object

    المطلوب في هذا الفرع: currency, status, reserved_quota, final_quota, reserved_amount, final_amount

    • currencystringمطلوب

      عملة عرض السعر/الفوترة.

    • error_codestringاختياري

      رمز خطأ عام يمكن استخدامه في منطق التفرّع.

    • statusstringمطلوب

      حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

    • reserved_quotaintegerمطلوب

      الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

    • final_quotaintegerمطلوبيسمح بـ null

      التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

    • reserved_amountstringمطلوب

      الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.

    • final_amountstringمطلوبيسمح بـ null

      الرسوم النهائية كسلسلة نصية؛ تعني null عدم التسوية بعد.

  • storageobjectاختياري

    حالة حفظ الملف المستقلة.

    الحقول الفرعية لـ storage (3)
    • file_idstringاختياري

      المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • statusstringمطلوب

      حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

    • error_codestringاختياري

      رمز خطأ عام يمكن استخدامه في منطق التفرّع.

    فرع allOf رقم 1

    النوع: object

    المطلوب في هذا الفرع: status

    • file_idstringاختياري

      المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • statusstringمطلوب

      حالة الكائن الحالية؛ قيّمها بصورة منفصلة عن الفوترة ومرحلة الحفظ.

    • error_codestringاختياري

      رمز خطأ عام يمكن استخدامه في منطق التفرّع.

  • availabilityobjectاختياري

    الإجراءات المتاحة حاليًا.

    الحقول الفرعية لـ availability (4)
    • can_cancelbooleanمطلوب

      هل تسمح المهمة الحالية بطلب الإلغاء.

    • can_deletebooleanمطلوب

      هل تسمح المهمة الحالية بالحذف.

    • can_retry_storagebooleanمطلوب

      هل تسمح المهمة الحالية بإعادة محاولة الحفظ.

    • reasonstringاختياري

      السبب العام لتعذر الإجراء أو مراجعة الحسابات.

    فرع allOf رقم 1

    النوع: object

    المطلوب في هذا الفرع: can_cancel, can_delete, can_retry_storage

    • can_cancelbooleanمطلوب

      هل تسمح المهمة الحالية بطلب الإلغاء.

    • can_deletebooleanمطلوب

      هل تسمح المهمة الحالية بالحذف.

    • can_retry_storagebooleanمطلوب

      هل تسمح المهمة الحالية بإعادة محاولة الحفظ.

    • reasonstringاختياري

      السبب العام لتعذر الإجراء أو مراجعة الحسابات.

  • idstringمطلوب

    المعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.

  • modelstringمطلوب

    معرّف نموذج عام من دليل المفتاح الحالي.

  • statusstringمطلوب

    حالة المهمة العادية أو الدائمة؛ قد تكون pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. لا تعني الحالة النهائية تسوية الفوترة أو جاهزية الأرشفة.

  • created_atintegerمطلوب

    وقت الإنشاء بثواني Unix.

  • resultobjectاختياري

    بيانات وصفية للنتائج الجاهزة؛ قد لا تتوفر قبل الاكتمال.

    الحقول الفرعية لـ result (8)
    • file_idstringاختياري

      المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • storage_statusstringاختياري

      حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

    • deliverystringاختياري

      يعني authenticated_content وجوب استخدام مسار المحتوى؛ لا تفترض وجود URL مباشر.

    • content_pathstringاختياري

      مسار محتوى مصادَق عليه من المنصة؛ اطلب المحتوى الثنائي بالمفتاح نفسه.

    • urlstringاختياري

      رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

    • content_typestringاختياري

      نوع MIME للنتيجة.

    • file_namestringاختياري

      اسم الملف العام للتنزيل.

    • file_sizeintegerاختياري

      حجم ملف النتيجة بالبايت.

    فرع allOf رقم 1

    النوع: object

    • file_idstringاختياري

      المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

    • storage_statusstringاختياري

      حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

    • deliverystringاختياري

      يعني authenticated_content وجوب استخدام مسار المحتوى؛ لا تفترض وجود URL مباشر.

    • content_pathstringاختياري

      مسار محتوى مصادَق عليه من المنصة؛ اطلب المحتوى الثنائي بالمفتاح نفسه.

    • urlstringاختياري

      رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

    • content_typestringاختياري

      نوع MIME للنتيجة.

    • file_namestringاختياري

      اسم الملف العام للتنزيل.

    • file_sizeintegerاختياري

      حجم ملف النتيجة بالبايت.

  • errorstringاختياري

    فئة فشل أو كائن خطأ عام.

HTTP 401

Key مفقود أو غير صالح أو منتهي أو ملغى.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 403

المفتاح الحالي لا يملك الصلاحية.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (3)
    • messagestringمطلوب
    • typestringمطلوب
      القيم المعدودة
      ["new_api_error"]
    • codestringمطلوب

HTTP 404

الكائن أو الإمكانية غير متاحين.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (3)
    • messagestringمطلوب
    • typestringمطلوب
      القيم المعدودة
      ["new_api_error"]
    • codestringمطلوب

HTTP 409

تعارض في الطلب، أو عدم جاهزية، أو إرسال غير معروف النتيجة. استعلم عن السجل الأصلي أولًا؛ ولا تُعِد الإرسال دون تحقق.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (3)
    • messagestringمطلوب
    • typestringمطلوب
      القيم المعدودة
      ["new_api_error"]
    • codestringمطلوب

HTTP 410

حُذفت مهمة الفيديو (task_deleted) ولم يعد بالإمكان قراءة نتائجها.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 429

حد معدل الطلبات/قائمة الانتظار.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 500

فشل داخلي في المصادقة أو تخزين البيانات.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 502

خطأ في استجابة الخدمة.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (3)
    • messagestringمطلوب
    • typestringمطلوب
      القيم المعدودة
      ["new_api_error"]
    • codestringمطلوب

HTTP 503

الخدمة أو التخزين أو التسعير غير متاحة مؤقتًا.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (3)
    • messagestringمطلوب
    • typestringمطلوب
      القيم المعدودة
      ["new_api_error"]
    • codestringمطلوب