واجهة Magnific Video Upscaler API: الأسعار وطريقة العمل

رفع دقة الفيديو مكلف بطريقة لا يكون بها رفع دقة الصور مكلفًا أبدًا. مقطع مدته 60 ثانية بمعدل 24 إطارًا في الثانية يساوي 1,440 صورة منفصلة، ويُحتسب كل منها في الفاتورة. هذه الحقيقة الواحدة تفسّر تقريبًا كل شيء في طريقة تسعير API أداة Magnific لرفع دقة الفيديو، ولماذا يبدو اختبار سريع على مقطع قصير رخيصًا، بينما لا تبدو مهمة الدفعات الكبيرة كذلك. يستعرض هذا المقال طريقة عمل API، وتأثير كل معامل على مادتك، وما تصل إليه أسعار كل إطار، وما الذي يجب استخدامه حين يكون دمج API أكثر تعقيدًا مما تستحقه المهمة.

ما الذي تفعله أداة Magnific لرفع دقة الفيديو

بدأت Magnific كأداة إسبانية لرفع دقة الصور بالذكاء الاصطناعي، واشتهرت بإضافة تفاصيل مُختلقة إلى الصور الباهتة منخفضة الدقة. استحوذت Freepik عليها في عام 2024، وتدير الشركة اليوم أدواتها الذكية تحت اسم Magnific، مع توثيق للمطورين على docs.magnific.com. تطبّق أداة رفع دقة الفيديو الفكرة نفسها على اللقطات المتحركة: ترسل مقطعًا، وتختار دقة مستهدفة تصل إلى 4K، وتحصل على ملف أوضح يحتوي على تفاصيل أُعيد بناؤها.

هذه خدمة مستضافة وغير متزامنة. أنت لا تشغّل النموذج بنفسك أبدًا. ترسل مهمة، وتنتظر، ثم تجمع رابط الملف الناتج. هذا يجعل ربطها بتطبيق أو بطابور تصيير أو بأداة أتمتة أمرًا سهلًا، ويعني أيضًا أن كل قرار يتعلق بالجودة يتم عبر عدد قليل من المعاملات الرقمية.

وضعا التوليد الإبداعي والدقة

تتيح Magnific نوعين من رفع دقة الفيديو، واختيار النوع المناسب أهم من أي شريط تمرير.

يُسمح لأداة الرفع الإبداعية باختلاق الملمس، وهذا يفيد عندما يكون المصدر باهتًا. أما أداة الدقة فتمزج النتيجة مرة أخرى باتجاه الأصل عبر إعداد strength، فتبقى الوجوه والشعارات والأنماط الدقيقة أقرب إلى ما تم تصويره. تعرض صفحة النظرة العامة أيضًا مسارًا منفصلًا للسرعة لمعالجة أسرع، وتُشارَك حدود معدل الطلبات بين نقطتي النهاية القياسية والسريعة.

من يحتاج إليها فعلًا

• استوديوهات الترميم التي تعيد الأشرطة القديمة ومقاطع الهواتف المبكرة إلى مستوى الشاشات الحديثة
• فرق المنتجات التي تريد فيديوهات عرض بدقة 4K من تسجيلات شاشات بدقة 1080p
• المطورون الذين يبنون رفع الدقة داخل تطبيق يتفاعل مع webhooks
• الوكالات التي تمرّر عشرات المقاطع الاجتماعية عبر الإعدادات نفسها كل أسبوع

إذا لم تنتمِ إلى أيٍّ من هذه المجموعات، فانتقل مباشرة إلى القسم الخاص بالوقت الذي يكون فيه API مبالغًا فيه.

كيف يعمل API خطوة بخطوة

تتكون العملية كلها من ثلاث خطوات: إنشاء مهمة، وانتظارها، ثم جلب النتيجة. لا يجري بث أي شيء، ولا يتوقف شيء أثناء تشغيل رفع الدقة.

المصادقة وأول طلب

تحمل كل عملية استدعاء بيانات اعتماد واحدة من API في ترويسة طلب مخصصة. يُكتب اسم الترويسة الدقيق في أعلى صفحة كل نقطة نهاية في الوثائق، لذا انسخه من هناك بدلًا من تخمينه. الحقل الوحيد المطلوب في جسم الطلب هو video، وهو عنوان HTTPS متاح للعامة يشير مباشرة إلى الملف.

{
  "video": "https://example.com/clips/harbour-720p.mp4",
  "resolution": "4k",
  "creativity": 20,
  "sharpen": 15,
  "smart_grain": 5,
  "flavor": "natural",
  "fps_boost": false,
  "output_format": "h264",
  "webhook_url": "https://example.com/hooks/upscale-finished"
}

نسخ الأمر النصي

يعيد الاستدعاء الناجح الرمز 200 مع مظروف صغير:

{
  "data": {
    "task_id": "00000000-0000-0000-0000-000000000000",
    "status": "CREATED",
    "generated": []
  }
}

نسخ الأمر النصي

تعود الإخفاقات بالرمز 400 عند وجود مشكلات في التحقق، والرمز 401 عند غياب بيانات الاعتماد أو عدم صحتها، والرمز 500 أو 503 عندما تكون الخدمة نفسها تعاني.

الاستطلاع الدوري و Webhooks

لديك طريقتان لمعرفة انتهاء المهمة. استطلع GET /v1/ai/video-upscaler/{task-id} حتى تتغير الحالة، أو مرّر webhook_url ودع Magnific تتصل بك. تنتقل المهمة من CREATED إلى IN_PROGRESS وتنتهي عند FAILED أو حالة نجاح نهائية، وعندها تحتوي مصفوفة generated على روابط الملفات الناتجة. أما GET على /v1/ai/video-upscaler فيعرض قائمة مهامك، وهذا مفيد بعد تعطل النظام، عندما تحتاج إلى العثور على مهام فقدت أثرها.

💡 نصيحة: احفظ task_id فور الحصول عليه، وانسخ الملفات المكتملة إلى مساحة تخزينك الخاصة فورًا. تعامل مع الروابط المُعادة على أنها مؤقتة إلى أن يَعِد التوثيق بغير ذلك.

في حالة عدد قليل من المقاطع، يكفي الاستطلاع مع تأخير متزايد. أما في الدفعات، فإن webhooks توفّر عليك حلقة تكرار وكمًّا كبيرًا من الطلبات المهدورة.

قواعد الإدخال التي تُربك الناس

• يجب أن يكون الرابط HTTPS وعامًا. إذا استخدمت رابطًا موقّعًا مسبقًا، فتأكد من أنه يبقى صالحًا مدة كافية كي تتمكن Magnific من جلب الملف.
• لا ينشر التوثيق حدودًا للمدة أو لحجم الملف أو لصيغة الحاوية، لذا اختبر أطول مقطع وأثقله قبل بناء خط معالجة يعتمد على الخدمة.
• المصدر المضغوط بشكل سيئ يحدّ من النتيجة. يمكن لرفع الدقة أن يختلق ملمسًا، لكنه لا يستطيع استعادة وجه أفسده المُرمِّز بالفعل.

كل معامل بلغة بسيطة

تشكّل تسعة إعدادات المخرجات. معظمها يكون افتراضيه صفرًا أو مُعطّلًا، ما يعني أن الطلب المجرد يعطي نتيجة نظيفة ومحافظة بدقة 2K.

الإبداع والتحديد والحبيبات الذكية

الإبداع هو المقبض الذي يفصل بين رفع دقة وفيّ وبين إعادة طلاء للصورة. عند 0 يبقى النموذج حذرًا. القيم الأعلى تضيف ملمسًا، وهذا يُحسّن المناظر الطبيعية والأقمشة لكنه قد يغيّر الوجوه. نقطة بداية معقولة للأشخاص تكون بين 0 و25، وأعلى للمناظر أو للمواد القديمة التي بقيت فيها تفاصيل قليلة.

يجب أن يبقى التحديد منخفضًا. عند دفعه بعيدًا يُنتج هالات حول الحواف تبدو أسوأ من الضبابية التي حلّت محلها. تضيف الحبيبات الذكية حبيبات الفيلم فوق ذلك، ومقدار صغير منها (مثلًا من 5 إلى 10) وسيلة رخيصة لإخفاء المظهر البلاستيكي الذي تبدو عليه أحيانًا عمليات رفع الدقة النظيفة جدًا.

النكهة وتعزيز FPS

النكهة لها خياران. اعتبر vivid المظهر الأكثر حدّة، في حين أن natural هو المظهر المتحفظ، ثم شغّل الاثنين على المقطع نفسه الذي مدته ثلاث ثوانٍ قبل أن تلتزم بدفعة كاملة.

تعزيز FPS يرفع معدل الإطارات لحركة أنعم، وله أثر على الفوترة موضح أدناه. في نقطة نهاية الدقة تنص التوثيقات على أن strength يُتجاهل عند تشغيل fps_boost، ويُطبَّق رفع الدقة الكامل.

مخرجات H.264 أو ProRes

h264 الافتراضي يُعيد ملف MP4 عاديًا. اختر prores_422_hq عندما يكون الملف متجهًا إلى جدول تدرّج الألوان أو المونتاج: ستحصل على معاينة بصيغة H.264 بالإضافة إلى ملف ProRes 422 HQ .mov. ملفات ProRes كبيرة، لذا خصّص مساحة التخزين ووقت النقل قبل تفعيله لمقطع طويل.

التكلفة الحقيقية لرفع الدقة

تصف وثائق Magnific تسعيرًا قائمًا على الإطارات يختلف حسب دقة الإخراج، وتحيلك إلى صفحة الأسعار للحصول على الأرقام. تأتي أوضح أسعار الإطار العامة من صفحة أسعار API في Runway، وهي الصفحة التي تدرج أداة Magnific الإبداعية لرفع دقة الفيديو. استخدمها كنقطة مرجعية، وتحقّق من صفحة Magnific نفسها قبل أن تلتزم بميزانية.

حساب التسعير القائم على الإطارات

الصيغة بسيطة: التكلفة = عدد الإطارات × السعر، حيث يساوي عدد الإطارات معدل الإطارات في الثانية مضروبًا في المدة بالثواني.

تحوّل Runway الدولارات إلى نقاط بمعدل سنت واحد لكل نقطة، وتقرّب الناتج إلى الأعلى، مع حد أدنى نقطة واحدة لكل توليد. لاحظ شكل المنحنى: يكلّف 4K حوالي 33% أكثر لكل إطار من 2K، وحوالي 71% أكثر من 720p. القفزة من 720p إلى 4K ليست كبيرة لكل إطار، لكنها تتراكم على آلاف الإطارات.

ثلاثة أمثلة محسوبة

لنحسبها لدفعة: 100 مقطع مدة كل منها 15 ثانية بمعدل 30 fps يساوي 45,000 إطار، أي $405 بدقة 2K أو $540 بدقة 4K. هذا هو الرقم الذي يجب أن تتحقق منه قبل أن تُؤتمت أي شيء.

مضاعفات خفية يجب الانتباه إليها

• تعزيز FPS يغيّر عدد الإطارات الناتجة، لذلك تتبع الفاتورة العدد الجديد لا عدد الإطارات في مدخلك.
• في نقطة نهاية الدقة، تقول التوثيقات إن حسابات B2B ترى عدد الإطارات المفوترة في ترويسة استجابة X-Frames-Billed، مع حد أدنى 12 إطارًا ومضاعف 1.60x عند تفعيل fps_boost.
• الدقة الافتراضية هي 2K، لذا فإن الطلب الذي لا يتضمن resolution يُفوتَر بسعر 2K حتى لو كنت تحتاج إلى 720p فقط.

💡 نصيحة: شغّل كل مصدر جديد على مقطع اختبار مدته من 3 إلى 5 ثوانٍ بالدقة التي تنوي تسليمها. تكلّفه بضعة سنتات، وتريك المظهر الحقيقي قبل الفاتورة الحقيقية.

حدود المعدل وتخطيط الإنتاج

الإنتاجية هي القيد الثاني بعد السعر. وفقًا للتوثيقات، يسمح المستوى المجاني بعدد 10 طلبات يوميًا، ويسمح Tier 1 بعدد 125 طلبًا يوميًا، مع مشاركتها بين نقطتي النهاية القياسية والسريعة. أي حد أعلى يُرتّب مباشرة مع Magnific.

هذه الأرقام تحدد خطتك أكثر من السعر. عند Tier 1 تتسع دفعة من 100 مقطع في يوم واحد، بينما تحتاج 500 مقطع إلى أربعة أيام ما لم يرتفع حدك. يقوم خط معالجة متين عادةً بخمسة أشياء:

1. يخزّن كل task_id في قاعدة بيانات قبل أي شيء آخر
2. يرسل المقاطع حتى حد الطلبات اليومي، ويضع الباقي في طابور انتظار
3. يستخدم webhooks للنتائج، مع مهمة استطلاع بطيئة كشبكة أمان
4. يعيد المحاولة للمهام FAILED مع تأخير، ويحدد سقفًا لعدد المحاولات
5. يسجّل الإطارات المفوترة لكل مهمة حتى يمكن مطابقة الفواتير

متى يكون API مبالغًا فيه

يكون API هو الأداة الصحيحة حين يكون رفع الدقة ميزة في منتجك أو مهمة متكررة. وهو الأداة الخاطئة لمقطع واحد في عصر يوم ثلاثاء.

تكلفة الإعداد هي البند الخفي في الفاتورة. استضافة المصدر على عنوان HTTPS عام، ومعالجة الإخفاقات، وتخزين النتائج، قد تستغرق وقتًا أطول من رفع الدقة نفسه في مهمة صغيرة.

كيفية استخدام رفع دقة الفيديو على PicassoIA

بالنسبة للمقاطع الفردية، تعمل Video Upscale على PicassoIA داخل المتصفح بدون بيانات اعتماد، ودون استضافة عامة، ودون استطلاع. تحتاج إلى ثلاثة مدخلات: video (مطلوب)، ثم target_resolution (720p أو 1080p أو 4k، والافتراضي 4k)، ثم target_fps (من 15 إلى 120، والافتراضي 30).

الإعدادات خطوة بخطوة

1. افتح صفحة نموذج Video Upscale وارفع مقطعك.
2. اضبط target_resolution. اختر 4k لمواد الأرشيف والشاشات الكبيرة، أو 1080p عندما يكون المقطع متجهًا إلى خلاصات التواصل الاجتماعي.
3. اضبط target_fps. أبقه مساويًا للمصدر لترقية حدة خالصة، أو ارفع مادة 30 fps إلى 60 لحركة أنعم.
4. شغّل النموذج ونزّل النتيجة الخالية من العلامة المائية.
5. قارن إطارًا واحدًا من المخرجات بالأصل على الشاشة الكاملة قبل النشر.

يعيد النموذج بناء التفاصيل الدقيقة بدلًا من مطّ البكسلات، ويولّد الإطارات الوسيطة في المرور نفسه، فتعالج تشغيلة واحدة الدقة وسلاسة الحركة معًا.

Runway Upscale v1 للمقاطع القصيرة

Upscale v1 من Runway يقبل مدخلًا واحدًا ويكبّر المقطع 4 مرات، حتى 4K. حدوده واضحة: يجب أن تكون الفيديوهات أقصر من 40 ثانية، وأقل من 4096 بكسل في كل ضلع، وأقل من 16 MB. هذا يناسب الريلز والإعلانات الترويجية والعروض جيدًا، بما فيها المقاطع المولّدة باستخدام Veo 3.1 أو Seedance 2.0. أما الصور الثابتة، فإن Topaz Image Upscale يتولى التكبيرات حتى 6 مرات.

هذه محركات مختلفة عن Magnific، لذلك لن تتطابق النتائج إطارًا بإطار. شغّل المقطع نفسه على كل منها، وقيّم بعينيك.

جرّبها على مادتك الخاصة

أفضل اختبار لا يكلف شيئًا: خذ المقطع الأقل وضوحًا على قرصك، وشغّله عبر Video Upscale على Picasso IA بدقة 4k، وضع النتيجة بجانب الأصل على مشغل بملء الشاشة. إذا أقنعك الفرق، فاجعله عادة. وإذا احتجت إلى المقطع في سير عمل تطبيق، فستعرف بالضبط ما الذي تطلبه من API.

تصفّح الكتالوج الكامل على picassoia.com/en/all-models، وجرّب الأداتين على مقطع يهمك، وانظر كم من المادة القديمة التي ظننت أنها ضاعت يمكن أن تعود.