SubDL Pro: خطة المطوّرين لتطبيقات الترجمة والأتمتة

SubDL Pro هو طبقة API المدفوعة للمطورين الذين يريدون بناء سير عمل موثوق للترجمات النصية فوق SubDL. صمم لإضافات التلفزيون، والروبوتات، وأدوات خوادم الوسائط، والتطبيقات الخاصة، ولوحات الترجمة، والخدمات التي تحتاج إلى حدود أعلى مما يقدمه مفتاح API مجاني.

يجب أن تفعل API الترجمة النصية أكثر من إرجاع رابط تنزيل. التكاملات الحقيقية تحتاج إلى بحث عن العنوان، ومطابقة الإصدار، وتصفية اللغة، وملفات مواسم مفكوكة، وحدود تنزيل منطقية، وتدوير مفاتيح، وحالة الحساب، وطريقة للتعامل مع اللغات المفقودة. صمم SubDL Pro لتسهيل تشغيل هذه المسارات.

الحصة والسعر الأساسيان

منتج API الحالي لديه خياران فعالان للدفع: 5 دولارات شهريا و50 دولارا سنويا. كلاهما يتضمن حاليا 30,000 طلب API يوميا و2,000 تنزيل ترجمة يوميا بمفتاح موثق. ويمكن أن يطبق checkout بالعملات الرقمية سعرا مخفضا عند توفره، بينما يستخدم PayPal السعر الفعال المعروض عند الدفع.

هذه الحدود على مستوى الحساب. وهذا مهم لأن كثيرا من المشاريع الحقيقية تستخدم أكثر من مفتاح: إضافة production، ومفتاح staging، وعامل server-side، ولوحة اختبار، وربما روبوت خاص. يسمح SubDL Pro للحساب بامتلاك الحصة بينما تبقى المفاتيح الفردية قابلة للإدارة.

مفاتيح API قابلة للإدارة

يدعم SubDL Pro عدة مفاتيح API، مع أدوات للإنشاء، والتعطيل، والتفعيل، والحذف الناعم، والتدوير. قد يبدو هذا تفصيلا إداريا، لكنه أحد أهم أجزاء التكامل المتين.

المفتاح الواحد الدائم خطر. إذا تسرب، يجب تحديث كل العملاء دفعة واحدة. وإذا تقاعدت إضافة قديمة، يمكن أن يستمر مرورها في استهلاك الحصة. وإذا تصرفت بيئة اختبار بشكل سيئ، فقد تؤثر في الإنتاج. المفاتيح المنفصلة القابلة للإدارة تعزل هذه الحالات. يمكنك تسمية مفتاح لتطبيق معين، ومراقبة عدادته، وتعطيله عند الحاجة، وإبقاء بقية النظام تعمل.

نقطة حالة الحساب

تسمح نقطة حالة الحساب للعميل بفحص مستخدم مفتاح API، وحالة المفتاح، وعدادات الاستخدام، وحدود الطلب والتنزيل على مستوى الحساب، والخطة المدفوعة النشطة، ونهاية الفترة، ومعلومات حصة الترجمة عند وجودها.

يجب أن يستخدم أي plugin جيد هذه النقطة قبل أن يفترض أن المستخدم يستطيع تنفيذ عملية مدفوعة. يمكنه عرض عدد الطلبات المتبقية اليوم، وما إذا كانت تنزيلات API متاحة، وما إذا كان للحساب خطة مدفوعة. هذا يجعل معالجة الأخطاء أوضح ويوفر مسار ترقية أفضل عندما تتطلب ميزة ما SubDL Pro.

البحث و autocomplete

يتضمن SubDL Pro نقاط autocomplete و search مدفوعة لاكتشاف العناوين. autocomplete مفيد لصناديق البحث، وأوامر الروبوتات، ومسارات lookup في مديري الوسائط، والإضافات التي تحتاج إلى تحويل نص مكتوب إلى فيلم أو مسلسل حقيقي. أما search فيفيد عندما يحتاج العميل إلى مطابقة أوسع مع تلميحات نوع مثل movie أو tv.

تتطلب نقاط البحث المدفوعة اشتراك API مدفوعا نشطا، وتحتسب ضمن حصة طلبات الحساب، وتسمح بحد burst قوي لكل مفتاح. هذا مفيد للواجهات الحقيقية، حيث قد يولد مستخدم واحد يكتب في مربع بحث عدة طلبات سريعة.

بحث الترجمة وذكاء اللغة

تبقى نقطة بحث الترجمة العامة هي الأساس. يمكن للعملاء البحث باسم الفيلم، واسم الملف، و SubDL ID، و IMDb ID، و TMDB ID، والنوع، والسنة، والموسم، والحلقة، واللغة. ويمكنهم طلب التعليقات، والإصدارات، وعلامات hearing impaired، وترجمات الموسم الكامل، والملفات المفكوكة من حزم الترجمة.

بالنسبة للعملاء الحديثين، تعد بيانات اللغة مهمة جدا. يمكن أن تتضمن استجابات البحث available_languages، أي اللغات الموجودة بالفعل للعنوان، و missing_translation_languages، أي اللغات الهدف المدعومة وغير المتاحة بعد. هذا يحول طريقا مسدودا إلى لحظة منتج: يمكن للتطبيق أن يقول مثلا إن الإنجليزية موجودة لكن الفارسية مفقودة، ثم يوجه المستخدم المدفوع نحو الترجمة.

تنزيلات موثقة بالمفتاح

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

يتضمن SubDL Pro حاليا 2,000 تنزيل ترجمة يوميا بمفتاح API. يمكن للعميل تمرير المفتاح ك api_key في رابط التنزيل أو إرساله عبر header x-api-key. والنتيجة مسار تنزيل أنظف وأكثر قابلية للتوقع للاستخدام الآلي الشرعي.

مهام الترجمة عبر API

نظام الترجمة في SubDL غير متزامن عن قصد. يستطيع المستخدمون المدفوعون الذين يملكون حصة ترجمة نشطة طلب لغة ترجمة مفقودة عبر API ترجمة Pro. يعيد طلب البدء request ID، ثم يفحص العميل نقطة المهمة حتى تصبح الترجمة جاهزة للتنزيل.

هذا المسار أفضل من إبقاء طلب HTTP واحد مفتوحا. قد تشمل الترجمة توجيه النموذج، وحجز الحصة، وتحليل الملف، والتقدم سطرا بسطر، والنشر، وإعادة الاستخدام، وإنشاء التنزيل. يجب أن يتعامل عميل API الجيد مع الترجمة كمهمة: يبدأها، يعرض تقدمها، يتعامل مع فشلها، وينزل الملف فقط بعد أن تصبح download_ready صحيحة.

تنطبق فكرة إعادة الاستخدام نفسها عبر API. إذا طلب المستخدم نفسه الملف المصدر نفسه واللغة الهدف نفسها والنبرة نفسها، يمكن ل SubDL إعادة استخدام ترجمة مكتملة بدلا من بدء عمل AI جديد واستهلاك الحصة مرة أخرى.

نمط التكامل الموصى به

يتبع تكامل SubDL Pro النظيف عادة هذا النمط:

1. استخدم نقطة الحساب لتأكيد حالة المفتاح والحدود وحالة الخطة.
2. استخدم autocomplete أو search للعثور على الفيلم أو المسلسل.
3. استخدم بحث الترجمة لجلب الترجمات المطابقة، وأسماء الإصدارات، واللغات، والملفات المفكوكة.
4. استخدم التنزيلات المدفوعة بالمفتاح لتدفقات التنزيل الآلية.
5. إذا كانت اللغة المطلوبة مفقودة ولدى الحساب حصة ترجمة، ابدأ مهمة ترجمة.
6. افحص حالة المهمة حتى يصبح الملف جاهزا، ثم نزله.

يعمل هذا النمط مع إضافات التلفزيون، وروبوتات الترجمة، وأدوات الوسائط الخاصة، والتطبيقات الصغيرة لأنه صريح. يعرف العميل ما يستطيع الحساب فعله، وما يحتويه العنوان، وما اللغة المفقودة، وأي خطوة تحدث الآن.

من يجب أن يختار SubDL Pro

اختر SubDL Pro إذا كان مشروعك يعتمد على SubDL بانتظام. فهو مفيد خصوصا للمطورين الذين يحتاجون إلى سعة طلبات يومية أعلى، وحصة تنزيل قابلة للتوقع، ومفاتيح متعددة، و search و autocomplete للإنتاج، أو أتمتة لا ينبغي ضغطها عبر حدود مجهولة.

إذا كنت مشاهدا عاديا يريد فقط ترجمة وتنزيل الترجمات من الموقع، فقد يكون SubDL Plus أبسط. وإذا كنت تبني تطبيقا أو إضافة أو روبوتا أو تكاملا، فإن SubDL Pro هو الخطة المصممة لسير عملك. وإذا كنت تحتاج إلى ترجمة موجهة للبشر وسعة API آلية، فإن SubDL Pro هو الخيار الأقوى، فهو يتضمّن بالفعل كل ما في SubDL Plus.

خلاصة

SubDL Pro لا يتعلق بالأرقام الأكبر فقط. القيمة الحقيقية هي الوضوح التشغيلي: مفاتيح مسماة، وعدادات مرئية، وحدود يومية أعلى، وبحث مدفوع، وتنزيلات موثقة بالمفتاح، وترجمة مبنية على المهام عندما يكون الحساب مؤهلا. هذا ما يحول API الترجمة من سكربت سريع إلى بنية يمكنك البناء عليها بثقة.