واجهة Video Eraser API لمعالجة ترجمة الفيديو وعلاماته المائية والعلامات المائية للصور

ما الذي تدعمه واجهة المطورين 550W فعليًا

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

معالجة ترجمة الفيديو والعلامة المائية

يمكن رفع فيديو MP4 أو MOV عبر /open/uploadVideo أو تمرير videoUrl عام إلى /open/submitTask. يتضمن الطلب أبعاد الفيديو ومدته والمستطيل المطلوب معالجته. تعمل المهام بصورة غير متزامنة وتُراجع حالتها عبر /open/taskDetail أو /open/taskList.

إزالة العلامة المائية من الصورة

تقبل /open/removeImageWatermark صور JPG وPNG وBMP وWebP وAVIF وTIFF وSVG بحجم يصل إلى 50 MB. يمكن انتظار النتيجة أو استلام مهمة للاستعلام لاحقًا. لا توفر واجهة Eraser تنزيل فيديو من رابط لإزالة علامته المائية، فلا تعد المستخدمين بهذه الإمكانية.

استخدم الواجهة لتنظيف النصوص من الفيديو والصور المصرح بتحريرها ضمن الإمكانات الموثقة.

تسلسل طلبات صالح للإنتاج

يتطلب كل طلب userNo وapiKey. احتفظ بهما على خادمك؛ يمكن استخراج المفتاح من كود المتصفح أو التطبيق. ارفع الفيديو أولًا أو قدّم عنوان HTTP(S) عامًا يمكن للخدمة الوصول إليه.

المصادقة والرفع

أرسل /open/submitTask مع width وheight وduration والإحداثيات x1 وy1 وx2 وy2. يعالج وضع Standard (mode=normal، الإعداد الافتراضي) المنطقة داخل المستطيل المحدد. أما Protect ‏(mode=protect) فيحافظ على الداخل ويعالج الخارج، وليس وضعاً لجودة أعلى. اضبط removeAudio فقط إذا أردت حذف الصوت قبل المعالجة.

إرسال مهمة من دون تكرار

أرسل Idempotency-Key لا يتجاوز 128 حرفًا. إذا انقطع الاتصال بعد الإرسال، أعد الطلب المنطقي بالمفتاح نفسه كي لا تنشئ مهمة ثانية قابلة للفوترة. اربط taskId بمعرّف الأصل في نظامك.

استلام النتيجة والتحقق منها

للتسليم غير المتزامن استخدم callbackUrl عامًا عبر HTTP(S). عند وصول إشعار بالحالة النهائية، أكّد الاستلام سريعًا ثم تحقّق مجددًا عبر /open/taskDetail. اجعل استقبال الإشعار المتكرر آمنًا، واستخدم الاستعلام الدوري بديلًا عند تأخره.

حفظ المفاتيح على الخادم ومنع التكرار وتسجيل taskId والتحقق من الإشعار تجعل إعادة المحاولة قابلة للتتبع.

حدود الإدخال وضبط الجودة

تختلف هذه الحدود عن مسار الفيديو في المتصفح. افحص الصيغة والمدة والأبعاد وعمق اللون وHDR قبل الإرسال.

تحقق قبل استهلاك الرصيد

تعتمد النتيجة على الحركة خلف النص. الجدار الساكن والسماء أبسط عادةً من اليدين والشعر والأنماط والانعكاسات وحركة الكاميرا السريعة. أنشئ قائمة مراجعة للحالات الصعبة وافحص الفيديو كاملًا لا الصورة المصغرة وحدها.

راجع المشاهد الصعبة

تدعم مهام الصور صيغًا شائعة وتُحتسب تكلفة المهمة الناجحة بحسب صفحة الواجهة الحالية. احتفظ بالأصل واحفظ النتيجة نسخة مشتقة؛ إزالة العلامة المائية لا تمنح حقوق النشر أو الاستخدام التجاري.

ارفض الملفات غير المدعومة مبكرًا واطلب مراجعة بشرية حين تتقاطع المعالجة مع تفاصيل متحركة مهمة.

الفوترة والأخطاء وسياسة إعادة المحاولة

تُحسب تكلفة إزالة الترجمة بحسب المدة والدقة. السعر الحالي 1.3 رصيد لكل ثانية حتى 720p و1.6 رصيد فوق 720p حتى 1080p؛ أي نحو 39 أو 48 رصيدًا لفيديو من 30 ثانية. استعلم عن الرصيد عبر /open/queryCredits قبل قبول دفعة كبيرة.

قدّر التكلفة قبل الإرسال

تتضمن الاستجابة code وmessage، وتعرض المهمة status ثم resultUrl عند اكتمالها. قد تتضمن المهمة الفاشلة failCode وfailReason وrefundStatus. أعد المحاولة بعد أعطال النقل المؤقتة مع تأخير متزايد، ولا تكرر طلبًا بمعلمات خاطئة أو ملف غير مدعوم أو رصيد غير كافٍ من دون تصحيح السبب.

تعامل مع حقول الفشل المستقرة

سجّل زمن الإرسال والإنجاز ومعدل الفشل ورفض المراجعة وتكلفة الأصل الموافق عليه. تكشف هذه المقاييس إن كان التكامل يختصر العمل بالفعل.

قِس النتائج المعتمدة وتكلفتها الفعلية، لا نجاح طلبات HTTP وحده.

إطلاق التكامل في أربع خطوات

أنشئ مفتاحًا من صفحة المطورين وأرسل فيديو ممثلًا لعملك. بعدها اعرض حالات waiting وprocessing وsuccess وfailed في منتجك. أضف منع التكرار وإشعارًا مع استعلام احتياطي. ثم عالج دفعة صغيرة وراجع كل ملف مصدّر قبل زيادة الحمل.

ابدأ بتجربة محدودة

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