SubDL Pro: el plan para desarrolladores de apps de subtítulos y automatización

SubDL Pro es la capa API de pago para desarrolladores que quieren construir flujos de subtítulos fiables sobre SubDL. Está hecho para plugins de TV, bots, herramientas de media server, apps privadas, paneles de subtítulos y servicios que necesitan límites más altos que los de una clave API gratuita.

Una API de subtítulos debe hacer más que devolver un enlace de descarga. Las integraciones reales necesitan búsqueda de títulos, matching de releases, filtros de idioma, archivos de temporada desempaquetados, límites de descarga razonables, rotación de claves, estado de cuenta y una forma de manejar idiomas faltantes. SubDL Pro está diseñado para facilitar la operación de esos flujos.

Cuota principal y precios

El producto API actual tiene dos opciones activas de facturación: $5 mensual y $50 anual. Ambas incluyen actualmente 30,000 solicitudes API al día y 2,000 descargas de subtítulos al día autenticadas con clave. El checkout con criptomonedas puede aplicar un precio con descuento cuando está disponible, mientras que PayPal usa el precio efectivo mostrado en checkout.

Estos límites son a nivel de cuenta. Eso importa porque muchos proyectos reales usan más de una clave: un plugin de producción, una clave de staging, un worker server-side, un panel de pruebas y quizá un bot privado. SubDL Pro permite que la cuenta sea dueña de la cuota mientras las claves individuales siguen siendo gestionables.

Claves API gestionadas

SubDL Pro soporta múltiples claves API, con controles para crear, desactivar, activar, eliminar suavemente y rotarlas. Puede sonar como un detalle administrativo, pero es una de las partes más importantes de una integración duradera.

Una sola clave permanente es riesgosa. Si se filtra, todos los clientes deben actualizarse a la vez. Si un plugin se retira, el tráfico antiguo puede seguir golpeando tu cuota. Si un entorno de pruebas se comporta mal, puede afectar producción. Las claves separadas y gestionadas aíslan esos casos. Puedes nombrar una clave para una app concreta, ver sus contadores, desactivarla cuando haga falta y mantener vivo el resto del sistema.

Endpoint de estado de cuenta

El endpoint de cuenta permite que un cliente revise el usuario de la clave API, estado de la clave, contadores de uso, límites de requests y descargas a nivel de cuenta, plan de pago activo, final del periodo e información de cuota de traducción cuando existe.

Un buen plugin debería usar este endpoint antes de asumir que el usuario puede realizar una operación de pago. Puede mostrar cuántas solicitudes quedan hoy, si las descargas API están disponibles y si la cuenta tiene un plan pagado. Esto hace más claro el manejo de errores y ofrece una mejor ruta de upgrade cuando una función requiere SubDL Pro.

Search y autocomplete

SubDL Pro incluye endpoints pagados de autocomplete y search para descubrimiento de títulos. Autocomplete sirve para cajas de búsqueda, comandos de bots, flujos de lookup en media managers y plugins que necesitan convertir una consulta escrita en una entrada real de película o TV. Search sirve cuando el cliente necesita matching más amplio con pistas de tipo como movie o tv.

Los endpoints de búsqueda pagados requieren una suscripción API activa, cuentan contra la cuota account-wide de requests y permiten un límite burst fuerte por clave. Esto es útil para interfaces reales, donde un usuario escribiendo en una caja de búsqueda puede generar varias solicitudes rápidas.

Búsqueda de subtítulos e inteligencia de idiomas

El endpoint público de búsqueda de subtítulos sigue siendo la base. Los clientes pueden buscar por film name, file name, SubDL ID, IMDb ID, TMDB ID, type, year, season, episode y language. También pueden pedir comments, releases, flags hearing-impaired, subtítulos de temporada completa y archivos desempaquetados de paquetes de subtítulos.

Para clientes modernos, los metadatos de idioma son especialmente útiles. Las respuestas pueden incluir available_languages, que muestra los idiomas de subtítulos ya existentes para un título, y missing_translation_languages, que muestra idiomas destino soportados que todavía no están disponibles. Esto convierte un callejón sin salida en un momento de producto: la app puede decir, por ejemplo, que existe inglés pero falta persa, y guiar al usuario pagado hacia la traducción.

Descargas autenticadas con clave

Sin una clave pagada, las descargas permanecen bajo el limitador diario anónimo por IP. Con una clave API pagada válida, las descargas de subtítulos pueden consumir la cuota API de descargas a nivel de cuenta. Esto importa para apps y plugins porque muchos usuarios están detrás de redes compartidas, servidores domésticos o entornos de hosting donde los límites solo por IP son demasiado imprecisos.

SubDL Pro incluye actualmente 2,000 descargas de subtítulos al día autenticadas con clave. Un cliente puede pasar la clave como api_key en la URL de descarga o enviarla con el header x-api-key. El resultado es una ruta de descarga más limpia y predecible para uso automatizado legítimo.

Trabajos de traducción por API

El sistema de traducción de SubDL es intencionalmente asíncrono. Los usuarios pagados con cuota activa de traducción pueden solicitar un idioma de subtítulo faltante mediante la API de traducción Pro. La solicitud de inicio devuelve un request ID, y el cliente consulta el endpoint del trabajo hasta que el subtítulo esté listo para descargar.

Este flujo es mejor que mantener abierta una sola solicitud HTTP. La traducción puede implicar enrutamiento de modelo, reserva de cuota, parsing de archivo, progreso línea por línea, publicación, reutilización y generación de descarga. Un buen cliente API debe tratar la traducción como un trabajo: iniciarlo, mostrar progreso, manejar fallos y descargar el archivo solo cuando download_ready sea true.

La misma idea de reutilización aplica por API. Si el mismo usuario solicita el mismo archivo origen, idioma destino y tono, SubDL puede reutilizar una traducción completada en lugar de iniciar nuevo trabajo de IA y consumir cuota otra vez.

Patrón de integración recomendado

Una integración limpia con SubDL Pro suele seguir este patrón:

1. Usar el endpoint de cuenta para confirmar estado de clave, límites y plan.
2. Usar autocomplete o search para encontrar la película o serie.
3. Usar búsqueda de subtítulos para traer subtítulos coincidentes, releases, idiomas y archivos desempaquetados.
4. Usar descargas autenticadas con clave pagada para flujos automáticos.
5. Si falta el idioma necesario y la cuenta tiene cuota de traducción, iniciar un trabajo de traducción.
6. Consultar el estado del trabajo hasta que el archivo esté listo y descargarlo.

Este patrón funciona para plugins de TV, bots de subtítulos, herramientas privadas de media y apps pequeñas porque es explícito. El cliente sabe qué puede hacer la cuenta, qué tiene el título, qué idioma falta y qué paso está ocurriendo ahora.

Quién debería elegir SubDL Pro

Elige SubDL Pro si tu proyecto depende regularmente de SubDL. Es especialmente útil para desarrolladores que necesitan mayor capacidad diaria de requests, cuota de descarga predecible, múltiples claves, search y autocomplete en producción, o automatización que no debe pasar por límites anónimos.

Si eres un usuario normal que solo quiere traducir y descargar subtítulos en el sitio web, SubDL Plus probablemente sea el plan más simple. Si estás construyendo una app, plugin, bot o integración, SubDL Pro es el plan diseñado para tu flujo. Si necesitas tanto traducción para usuarios como capacidad API automatizada, SubDL Pro es la opción más fuerte, ya que incluye todo lo de SubDL Plus.

Cierre

SubDL Pro no trata solo de números más grandes. El valor real es la claridad operativa: claves con nombre, contadores visibles, límites diarios más altos, búsqueda pagada, descargas con clave y traducción basada en trabajos cuando la cuenta es elegible. Eso convierte una API de subtítulos de un script rápido en infraestructura sobre la que puedes construir con confianza.