كيف يعمل
تستخدم ترقية الفيديو نفس نظام الطابور غير المتزامن المستخدم في توليد الفيديو:- Queue — أرسل فيديوك إلى
/video/queueمع النموذجtopaz-video-upscale - Poll — استدعِ
/video/retrieveمعmodelوqueue_idالمُعاد. أثناء تشغيل المهمة، يُرجع JSON يحتوي على"status": "PROCESSING". عند انتهاء المهمة، يكون جسم الاستجابة هو ملف MP4 المُرقّى (Content-Type: video/mp4)، لذا احفظه في ملف. لا يوجد رابط إخراج. - Clean up (optional) — بعد حفظ الملف، استدعِ
/video/completeلحذف الإخراج المخزّن
معاملات الترقية
معامل
upscale_factor يحل محل resolution لنماذج الترقية. تمرير resolution سيُعيد خطأ. وذلك لأن دقّة الإخراج تعتمد على أبعاد فيديو الإدخال — فترقية 2x لفيديو 720p تنتج نتيجة مختلفة عن ترقية 2x لفيديو 480p.صيغ الإدخال المدعومة
- الصيغ: MP4، MOV، WebM
- طرق الإدخال: رابط HTTPS أو رابط بيانات
data:video/...;base64,... - أقصى مدة: 300 ثانية (5 دقائق)
استخدام API
إرسال مهمة ترقية إلى الطابور
queue_id لتتبّع المهمة:
الاستعلام وحفظ النتيجة
Content-Type قبل التحليل. يطبع مثال cURL نوع المحتوى لكل استجابة: كرّره حتى يطبع video/mp4، وعندها يحتوي upscaled.mp4 على الفيديو. إذا تضمنت استجابة الطابور download_url، فإن retrieve يُرجع بدلًا من ذلك JSON يحتوي على "status": "COMPLETED"، وتنزّل الملف من ذلك الرابط. راجع روابط التنزيل الخاصة.
التنظيف (اختياري)
بعد حفظ ملف MP4، يمكنك استدعاء/video/complete لحذف الإخراج المخزّن. لا يُرجع هذا الاستدعاء الفيديو ولا رابطًا.
معاملات API
معاملات لا تُستخدم لنماذج الترقية
المعاملات التالية لا تُقبل لـtopaz-video-upscale وستُعيد خطأ إذا قُدِّمت:
كذلك يُتجاهل معامل
duration — إذ يكتشف الخادم المدة مباشرة من ملف الفيديو لأجل دقّة الفوترة.
التسعير
يستند التسعير إلى المدة وفئة دقّة الإخراج ومعدل الإطارات. تُحدَّد فئة دقّة الإخراج بضرب ارتفاع فيديو الإدخال في معامل الترقية.فئات دقّة الإخراج
مقاطع الفيديو بمعدلات إطارات أعلى من 48fps تكلّف ضعف السعر لكل ثانية.
أمثلة تسعير
استخدم Video Quote API للحصول على التسعير الدقيق قبل إرسال المهمة.
الحصول على عرض سعر
video_url مطلوب لعروض الأسعار على نماذج رفع الدقة — تجلب نقطة نهاية الاقتباس الملف وتكتشف المدة ومعدل الإطارات والارتفاع من البايتات، فلا حاجة لتزويدها. حذفه يعيد 400 مع “video_url is required for quotes on this model”.
تتطلب عروض الأسعار لنماذج رفع الدقة مفتاح API. الطلبات التي لا تتضمنه تُعيد 403.
مرّر قيمة upscale_factor نفسها (1 أو 2 أو 4) إلى /video/quote التي سترسلها إلى /video/queue، كي يطابق عرض السعر المهمة. تقبل نقطة نهاية الاقتباس أيضًا resolution ("2x" أو "4x") كاسم بديل مُهمَل لنماذج رفع الدقة؛ وإذا أُرسل كلاهما، تكون الأولوية لـ upscale_factor.