مرجع API

الحصول على عرض سعر فيديو دائم

POST/v1/video-quotes

retention=persistent للتسعير وفق أوضاع الكتالوج والإطارات المستضافة؛ إغلاق الميزة يعيد 404 مباشرةً. انتهاء العرض أو تغير السعر يتطلب تأكيدًا جديدًا.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

جسم الطلب · application/json

النوع: object
الحقول المطلوبة: modelprompt
خصائص إضافية: 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
يعتمد على النموذج؛ استخدم سياسة الصوت والإعدادات المسبقة للوضع. لا تفترض أن كل نموذج يولّد صوتًا.

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

HTTP 200

تم الحصول على عرض سعر الفيديو الدائم بنجاح

application/json

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

idstringمطلوب
المعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.
expires_atintegerمطلوب
وقت انتهاء بثواني Unix؛ تعني 0 عدم وجود انتهاء ثابت.
request_hashstringمطلوب
ملخص الطلب المطبّع الذي يربط عرض السعر بالإنشاء؛ وليس مفتاح طلب منع التكرار.
pricing_kindstringمطلوب
طريقة التسعير المستخدمة فعليًا لعرض السعر هذا.
currencystringمطلوب
عملة عرض السعر/الفوترة.
reserved_quotaintegerمطلوب
الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.
reserved_amountstringمطلوب
الحد الأقصى للمبلغ المحجوز كسلسلة نصية بعملة عرض السعر.
estimated_final_amountstringمطلوبيسمح بـ null
المبلغ النهائي المقدر كسلسلة نصية؛ تعني null تعذّر تحديده قبل التوليد.
settlement_notestringمطلوب
وصف القياس والتسوية الفعليين.

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اختياري

ملاحظات نقطة النهاية

توضح هذه المعاملات إعدادًا مسبقًا كاملًا فقط. انسخ preset بأكمله (duration وresolution وaspect_ratio وgenerate_audio) للنموذج/الوضع model/mode المختارين من دليل video-models للمفتاح الحالي؛ ولا تستبدل النموذج وحده أو تخلط الإعدادات المسبقة.