الانتقال إلى المحتوى الرئيسي
تتيح لك ترقية دقّة الفيديو تحسين مقاطع الفيديو الحالية إلى دقّات أعلى مع تحسين الجودة البصرية. يستخدم نموذج Topaz Video Upscale ترقيةً مدفوعة بالذكاء الاصطناعي لرفع الدقّة بمعامل 2x أو 4x، أو لتطبيق تحسين جودة بنفس الدقّة الأصلية (1x).

كيف يعمل

تستخدم ترقية الفيديو نفس نظام الطابور غير المتزامن المستخدم في توليد الفيديو:
  1. Queue — أرسل فيديوك إلى /video/queue مع النموذج topaz-video-upscale
  2. Poll — تحقّق عبر /video/retrieve باستخدام queue_id المُعاد حتى تصبح الحالة completed
  3. Complete — استدعِ /video/complete لإنهاء المهمة والحصول على رابط الإخراج
يكتشف الخادم تلقائيًا مدة فيديو الإدخال ومعدل إطاراته وأبعاده من الملف المرفوع. لا تحتاج إلى تقديم هذه القيم — إذ تُحتسب الفوترة من بيانات الفيديو الفعلية.

معاملات الترقية

معامل upscale_factor يحل محل resolution لنماذج الترقية. تمرير resolution سيُعيد خطأ. وذلك لأن دقّة الإخراج تعتمد على أبعاد فيديو الإدخال — فترقية 2x لفيديو 720p تنتج نتيجة مختلفة عن ترقية 2x لفيديو 480p.

صيغ الإدخال المدعومة

  • الصيغ: MP4، MOV، WebM
  • طرق الإدخال: رابط HTTPS أو رابط بيانات data:video/...;base64,...
  • أقصى مدة: 300 ثانية (5 دقائق)

استخدام API

إرسال مهمة ترقية إلى الطابور

تتضمن الاستجابة queue_id لتتبّع المهمة:

الاستعلام عن الاكتمال

الإنهاء بـ complete

بعد استرجاع النتيجة، استدعِ /video/complete للإنهاء:

معاملات API

معاملات لا تُستخدم لنماذج الترقية

المعاملات التالية لا تُقبل لـ topaz-video-upscale وستُعيد خطأ إذا قُدِّمت: كذلك يُتجاهل معامل duration — إذ يكتشف الخادم المدة مباشرة من ملف الفيديو لأجل دقّة الفوترة.

التسعير

يستند التسعير إلى المدة وفئة دقّة الإخراج ومعدل الإطارات. تُحدَّد فئة دقّة الإخراج بضرب ارتفاع فيديو الإدخال في معامل الترقية.

فئات دقّة الإخراج

مقاطع الفيديو بمعدلات إطارات أعلى من 48fps تكلّف ضعف السعر لكل ثانية.

أمثلة تسعير

استخدم Video Quote API للحصول على التسعير الدقيق قبل إرسال المهمة.

الحصول على عرض سعر

تقبل نقطة نهاية الاقتباس input_height لتقدير فئة دقّة الإخراج. هذا اختياري — إذا حُذف، يفترض الاقتباس تقديرًا متحفظًا.

استكشاف الأخطاء وإصلاحها