SubDL Pro: Paket Developer untuk Aplikasi Subtitle dan Otomasi

SubDL Pro adalah layer API berbayar untuk developer yang ingin membangun workflow subtitle yang andal di atas SubDL. Ini dibuat untuk plugin TV, bot, alat media server, aplikasi privat, dashboard subtitle, dan layanan yang membutuhkan limit lebih tinggi daripada API key gratis.

API subtitle harus melakukan lebih dari sekadar mengembalikan link download. Integrasi nyata membutuhkan pencarian judul, release matching, filter bahasa, file season yang sudah di-unpack, limit download yang masuk akal, rotasi key, status akun, dan cara menangani bahasa yang belum tersedia. SubDL Pro dirancang untuk membuat workflow tersebut lebih mudah dioperasikan.

Kuota inti dan harga

Produk API saat ini memiliki dua opsi billing aktif: $5 per bulan dan $50 per tahun. Keduanya saat ini mencakup 30,000 request API per hari dan 2,000 download subtitle per hari dengan key yang diautentikasi. Checkout crypto dapat menerapkan harga diskon ketika tersedia, sedangkan PayPal memakai harga efektif yang ditampilkan saat checkout.

Limit ini berlaku di tingkat akun. Itu penting karena banyak proyek nyata memakai lebih dari satu key: plugin production, key staging, worker server-side, dashboard test, dan mungkin bot privat. SubDL Pro membuat kuota dimiliki akun, sementara key individual tetap bisa dikelola.

API key yang bisa dikelola

SubDL Pro mendukung beberapa API key, dengan kontrol untuk membuat, menonaktifkan, mengaktifkan, soft delete, dan merotasi key. Ini terdengar seperti detail admin, tetapi sebenarnya salah satu bagian terpenting dari integrasi yang tahan lama.

Satu key permanen berisiko. Jika bocor, semua client harus diperbarui sekaligus. Jika sebuah plugin dihentikan, trafik lama dapat terus menghabiskan kuota. Jika environment test bermasalah, production bisa ikut terpengaruh. Key terpisah yang bisa dikelola membuat kasus-kasus itu terisolasi. Anda bisa menamai key untuk app tertentu, melihat counternya, menonaktifkannya saat perlu, dan menjaga setup lain tetap berjalan.

Endpoint status akun

Endpoint akun API memungkinkan client memeriksa user pemilik API key, status key, counter penggunaan, limit request dan download tingkat akun, plan berbayar aktif, akhir periode, dan informasi kuota terjemahan jika ada.

Plugin yang baik sebaiknya memakai endpoint ini sebelum mengasumsikan user bisa melakukan operasi berbayar. Client bisa menampilkan berapa request tersisa hari ini, apakah API download tersedia, dan apakah akun memiliki plan berbayar. Ini membuat error handling lebih jelas dan memberi jalur upgrade yang lebih baik ketika fitur membutuhkan SubDL Pro.

Search dan autocomplete

SubDL Pro mencakup endpoint autocomplete dan search berbayar untuk title discovery. Autocomplete berguna untuk search box, perintah bot, lookup di media manager, dan plugin yang perlu mengubah query teks menjadi entry film atau TV yang nyata. Search berguna ketika client membutuhkan matching yang lebih luas dengan hint tipe seperti movie atau tv.

Endpoint search berbayar memerlukan subscription API berbayar aktif, dihitung ke kuota request account-wide, dan memungkinkan burst limit per-key yang kuat. Ini berguna untuk interface nyata, ketika satu pengguna yang mengetik di search box dapat memicu beberapa request cepat.

Pencarian subtitle dan kecerdasan bahasa

Endpoint public subtitle search tetap menjadi fondasi. Client dapat mencari berdasarkan film name, file name, SubDL ID, IMDb ID, TMDB ID, type, year, season, episode, dan language. Client juga dapat meminta comment, releases, flag hearing-impaired, subtitle full-season, dan file yang di-unpack dari paket subtitle.

Untuk client modern, metadata bahasa sangat berguna. Respons search dapat menyertakan available_languages, yaitu bahasa subtitle yang sudah ada untuk sebuah title, dan missing_translation_languages, yaitu bahasa target yang didukung tetapi belum tersedia. Ini mengubah jalan buntu menjadi momen produk: aplikasi dapat mengatakan, misalnya, bahasa Inggris tersedia tetapi Persia belum ada, lalu mengarahkan pengguna berbayar ke terjemahan.

Download dengan key

Tanpa key berbayar, download tetap berada di bawah anonymous daily IP limiter. Dengan API key berbayar yang valid, download subtitle dapat memakai kuota API download tingkat akun. Ini penting untuk app dan plugin karena banyak user berada di balik jaringan bersama, home server, atau environment hosting di mana limit berbasis IP saja terlalu kasar.

SubDL Pro saat ini mencakup 2,000 download subtitle per hari dengan API key. Client dapat mengirim key sebagai api_key pada URL download atau memakai header x-api-key. Hasilnya adalah jalur download yang lebih bersih dan lebih dapat diprediksi untuk penggunaan otomatis yang sah.

Job terjemahan melalui API

Sistem terjemahan SubDL sengaja asynchronous. Pengguna berbayar dengan kuota terjemahan aktif dapat meminta bahasa subtitle yang belum tersedia melalui Pro translation API. Request awal mengembalikan request ID, lalu client melakukan polling endpoint job sampai subtitle siap diunduh.

Flow ini lebih baik daripada menahan satu request HTTP tetap terbuka. Terjemahan dapat melibatkan model routing, reservasi kuota, parsing file, progres baris demi baris, publishing, reuse, dan pembuatan file download. API client yang baik harus memperlakukan terjemahan sebagai job: mulai, tampilkan progres, tangani kegagalan, dan download file hanya setelah download_ready bernilai true.

Ide reuse juga berlaku melalui API. Jika pengguna yang sama meminta file sumber yang sama, bahasa target yang sama, dan tone yang sama, SubDL dapat memakai ulang terjemahan selesai daripada memulai pekerjaan AI baru dan menghabiskan kuota lagi.

Pola integrasi yang disarankan

Integrasi SubDL Pro yang bersih biasanya mengikuti pola ini:

1. Gunakan endpoint akun untuk memastikan status key, limit, dan status plan.
2. Gunakan autocomplete atau search untuk menemukan judul film atau TV.
3. Gunakan subtitle search untuk mengambil subtitle yang cocok, release name, bahasa, dan file unpacked.
4. Gunakan download berbayar dengan key untuk alur download otomatis.
5. Jika bahasa yang dibutuhkan belum ada dan akun punya kuota terjemahan, mulai job terjemahan.
6. Poll status job sampai file siap, lalu download.

Pola ini bekerja untuk plugin TV, bot subtitle, alat media privat, dan aplikasi kecil karena eksplisit. Client tahu apa yang bisa dilakukan akun, apa yang tersedia pada title, bahasa apa yang belum ada, dan langkah apa yang sedang berjalan.

Siapa yang harus memilih SubDL Pro

Pilih SubDL Pro jika proyek Anda bergantung pada SubDL secara rutin. Paket ini sangat berguna untuk developer yang membutuhkan kapasitas request harian lebih tinggi, kuota download yang dapat diprediksi, beberapa key, search dan autocomplete production, atau otomasi yang tidak seharusnya dipaksa melalui limit anonim.

Jika Anda penonton biasa yang hanya ingin menerjemahkan dan mengunduh subtitle di website, SubDL Plus mungkin lebih sederhana. Jika Anda membangun app, plugin, bot, atau integrasi, SubDL Pro adalah paket yang dirancang untuk workflow Anda. Jika Anda membutuhkan terjemahan yang menghadap user sekaligus kapasitas API otomatis, SubDL Pro adalah pilihan terkuat — paket ini sudah mencakup semua yang ada di SubDL Plus.

Penutup

SubDL Pro bukan hanya soal angka yang lebih besar. Nilai sebenarnya adalah kejelasan operasional: named keys, counter yang terlihat, limit harian lebih tinggi, paid search, download dengan key, dan terjemahan berbasis job ketika akun memenuhi syarat. Itulah yang mengubah API subtitle dari script cepat menjadi infrastruktur yang bisa Anda bangun dengan percaya diri.