مرجع API

استرداد فيديو دائم بمفتاح الطلب

GET/v1/video-requests/{key}

فقط persistent وبالمفتاح نفسه للاستعادة. لا يعيد المسار حاليًا كامل فحوص سياسة النموذج، ولا يضمن توحيد إصلاح صلاحيات النماذج التاريخية.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

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

keystringمطلوب
Idempotency-Key للطلب الدائم الأصلي: حروف ASCII أو أرقام أو شرطات سفلية أو شرطات، بطول 1–128 بايت.

الحد الأدنى للطول
1
الحد الأقصى للطول
128
النمط
"^[A-Za-z0-9_-]+$"

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

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 400

حقول الطلب أو معاملاته غير صالحة.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 401

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

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 403

صلاحيات IP أو الحساب أو النموذج أو الأداة غير كافية.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 404

الكائن/الإمكانية غير متاحين، أو مفتاح الميزة معطّل.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 409

تعارض في منع التكرار/عرض السعر، أو كائن غير جاهز، أو ما يزال مشارًا إليه.

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 429

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

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 500

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

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري

HTTP 503

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

application/json

النوع: object
الحقول المطلوبة: error

errorobjectمطلوب
الحقول الفرعية لـ error (4)
- codestringاختياري
- messagestringاختياري
- typestringاختياري
- request_idstringاختياري