SubDL Pro: پلن توسعه‌دهندگان برای اپلیکیشن ها و اتوماسیون زیرنویس

SubDL Pro لایه پولی API برای توسعه دهندگانی است که می خواهند روی SubDL جریان کاری قابل اعتماد زیرنویس بسازند. این پلن برای پلاگین های تلویزیون، ربات ها، ابزارهای media server، اپلیکیشن های خصوصی، داشبوردهای زیرنویس و سرویس هایی ساخته شده که به محدودیت بالاتر از یک کلید رایگان API نیاز دارند.

یک API زیرنویس فقط نباید لینک دانلود برگرداند. integration واقعی به جستجوی عنوان، تشخیص release مناسب، فیلتر زبان، فایل های باز شده از پک فصل، محدودیت دانلود منطقی، چرخش کلید، وضعیت حساب و راهی برای مدیریت زبان های موجود نیست نیاز دارد. SubDL Pro برای ساده تر کردن عملیات همین جریان ها طراحی شده است.

سهمیه و قیمت اصلی

محصول فعلی API دو گزینه فعال پرداخت دارد: ماهانه 5 دلار و سالانه 50 دلار. هر دو در حال حاضر شامل 30,000 درخواست API در روز و 2,000 دانلود زیرنویس در روز با کلید احراز هویت شده هستند. پرداخت کریپتو در صورت فعال بودن می تواند قیمت تخفیفی checkout داشته باشد و PayPal قیمت موثر نمایش داده شده در checkout را استفاده می کند.

این محدودیت ها در سطح حساب اعمال می شوند. این نکته مهم است، چون بسیاری از پروژه های واقعی بیشتر از یک کلید دارند: یک پلاگین production، یک کلید staging، یک worker سمت سرور، یک داشبورد تست و شاید یک ربات خصوصی. SubDL Pro اجازه می دهد سهمیه متعلق به حساب باشد، در حالی که کلیدهای جداگانه همچنان قابل مدیریت می مانند.

کلیدهای API قابل مدیریت

SubDL Pro از چند کلید API پشتیبانی می کند و امکان ساخت، غیرفعال کردن، فعال کردن، حذف نرم و چرخش کلیدها را می دهد. این شاید یک جزئیات مدیریتی به نظر برسد، اما یکی از مهم ترین بخش های integration پایدار است.

یک کلید دائمی واحد ریسک دارد. اگر لو برود، همه کلاینت ها باید همزمان به روز شوند. اگر یک پلاگین کنار گذاشته شود، ترافیک قدیمی می تواند همچنان سهمیه را مصرف کند. اگر محیط تست بد رفتار کند، ممکن است production را تحت تاثیر قرار دهد. کلیدهای جدا و قابل مدیریت این موارد را جدا می کنند. می توانید هر کلید را برای یک اپلیکیشن نام گذاری کنید، شمارنده هایش را ببینید، در صورت نیاز غیرفعالش کنید و باقی سیستم را زنده نگه دارید.

endpoint وضعیت حساب

endpoint وضعیت حساب API به کلاینت اجازه می دهد کاربر مالک کلید، وضعیت کلید، شمارنده های مصرف، محدودیت های request و download در سطح حساب، پلن پولی فعال، پایان دوره و اطلاعات سهمیه ترجمه را در صورت وجود بررسی کند.

یک پلاگین خوب باید قبل از فرض کردن امکان عملیات پولی از این endpoint استفاده کند. می تواند نشان دهد امروز چند request باقی مانده، آیا دانلود API در دسترس است و آیا حساب پلن پولی دارد یا نه. این کار مدیریت خطا را روشن تر می کند و وقتی یک قابلیت به SubDL Pro نیاز دارد، مسیر ارتقا را بهتر نشان می دهد.

جستجو و autocomplete

SubDL Pro شامل endpoint های پولی autocomplete و search برای پیدا کردن عنوان است. autocomplete برای search box، دستورهای ربات، جریان lookup در media manager و پلاگین هایی مفید است که باید متن تایپ شده را به یک فیلم یا سریال واقعی تبدیل کنند. search زمانی مفید است که کلاینت به matching گسترده تر با hint نوع مثل movie یا tv نیاز دارد.

endpoint های جستجوی پولی به اشتراک فعال API نیاز دارند، در سهمیه request حساب شمرده می شوند و محدودیت burst قوی برای هر کلید دارند. این برای رابط های واقعی مهم است، چون یک کاربر هنگام تایپ در search box ممکن است چند درخواست سریع ایجاد کند.

جستجوی زیرنویس و هوشمندی زبان

endpoint عمومی جستجوی زیرنویس هنوز پایه اصلی است. کلاینت ها می توانند بر اساس نام فیلم، نام فایل، SubDL ID، IMDb ID، TMDB ID، نوع، سال، فصل، قسمت و زبان جستجو کنند. همچنین می توانند comment، release، وضعیت hearing impaired، زیرنویس فصل کامل و فایل های unpack شده از پک زیرنویس را درخواست کنند.

برای کلاینت های مدرن، متادیتای زبان بسیار مهم است. پاسخ های جستجو می توانند available_languages را نشان دهند؛ یعنی زبان هایی که همین حالا برای عنوان وجود دارند. همچنین missing_translation_languages می تواند زبان های مقصد قابل پشتیبانی را نشان دهد که هنوز موجود نیستند. این یک بن بست را به لحظه محصول تبدیل می کند: مثلا اپلیکیشن می تواند بگوید انگلیسی موجود است اما فارسی نیست، سپس کاربر پولی را به سمت ترجمه راهنمایی کند.

دانلود با کلید API

بدون کلید پولی، دانلودها زیر محدودیت روزانه IP ناشناس باقی می مانند. با یک کلید معتبر پولی، دانلود زیرنویس می تواند از سهمیه دانلود API در سطح حساب مصرف کند. این برای اپلیکیشن ها و پلاگین ها مهم است، چون بسیاری از کاربران پشت شبکه مشترک، home server یا محیط hosting هستند و محدودیت فقط بر اساس IP بیش از حد خام است.

SubDL Pro در حال حاضر 2,000 دانلود زیرنویس در روز با کلید API دارد. کلاینت می تواند کلید را به شکل api_key در URL دانلود بفرستد یا آن را با header x-api-key ارسال کند. نتیجه یک مسیر دانلود تمیزتر و قابل پیش بینی تر برای استفاده اتوماتیک قانونی است.

job های ترجمه از طریق API

سیستم ترجمه SubDL عمدا asynchronous است. کاربران پولی با سهمیه فعال ترجمه می توانند زبان مفقود زیرنویس را از طریق API ترجمه Pro درخواست کنند. درخواست شروع، یک request ID برمی گرداند و کلاینت endpoint job را poll می کند تا زیرنویس آماده دانلود شود.

این جریان بهتر از نگه داشتن یک درخواست HTTP باز است. ترجمه می تواند شامل route مدل، رزرو سهمیه، parsing فایل، پیشرفت سطر به سطر، انتشار، reuse و ساخت فایل دانلود باشد. کلاینت خوب باید ترجمه را مثل job ببیند: شروع کند، پیشرفت نشان دهد، شکست را مدیریت کند و فقط وقتی download_ready true شد فایل را دانلود کند.

ایده reuse از طریق API هم اعمال می شود. اگر همان کاربر همان فایل منبع، همان زبان مقصد و همان tone را درخواست کند، SubDL می تواند از ترجمه کامل قبلی استفاده کند و کار AI جدید شروع نکند و سهمیه را دوباره مصرف نکند.

الگوی پیشنهادی integration

یک integration تمیز SubDL Pro معمولا این الگو را دنبال می کند:

1. از endpoint حساب برای بررسی وضعیت کلید، محدودیت ها و وضعیت پلن استفاده کنید.
2. با autocomplete یا search عنوان فیلم یا سریال را پیدا کنید.
3. با جستجوی زیرنویس، زیرنویس های matching، release name، زبان ها و فایل های unpack شده را بگیرید.
4. برای جریان های دانلود اتوماتیک از دانلود با کلید پولی استفاده کنید.
5. اگر زبان لازم موجود نیست و حساب سهمیه ترجمه دارد، job ترجمه را شروع کنید.
6. وضعیت job را poll کنید تا فایل آماده شود، سپس آن را دانلود کنید.

این الگو برای پلاگین های تلویزیون، ربات های زیرنویس، ابزارهای private media و اپلیکیشن های کوچک جواب می دهد چون شفاف است. کلاینت می داند حساب چه کاری می تواند انجام دهد، عنوان چه چیزی دارد، چه زبانی کم است و اکنون کدام مرحله در حال اجراست.

چه کسانی SubDL Pro را انتخاب کنند

اگر پروژه شما به طور منظم به SubDL وابسته است، SubDL Pro را انتخاب کنید. این پلن مخصوصا برای توسعه دهندگانی مفید است که ظرفیت بالاتر request روزانه، سهمیه دانلود قابل پیش بینی، چند کلید، search و autocomplete production یا اتوماسیونی می خواهند که نباید زیر محدودیت ناشناس قرار بگیرد.

اگر کاربر عادی هستید و فقط می خواهید در وب سایت زیرنویس ترجمه و دانلود کنید، SubDL Plus احتمالا ساده تر است. اگر اپلیکیشن، پلاگین، ربات یا integration می سازید، SubDL Pro برای جریان کاری شما طراحی شده است. اگر هم به ترجمه کاربرمحور و هم ظرفیت API اتوماتیک نیاز دارید، SubDL Pro بهترین انتخاب است؛ چون همه امکانات SubDL Plus را هم در خود دارد.

جمع بندی

SubDL Pro فقط درباره عددهای بزرگ تر نیست. ارزش واقعی آن شفافیت عملیاتی است: کلیدهای نام دار، شمارنده های قابل مشاهده، محدودیت روزانه بالاتر، search پولی، دانلود با کلید API و ترجمه job-based وقتی حساب واجد شرایط است. همین ها یک API زیرنویس را از یک اسکریپت سریع به زیرساختی تبدیل می کند که می توانید با اطمینان روی آن محصول بسازید.