Re-Loadit: mejorar subtítulos con /document/convert

En nuestra serie Re-loadit presentamos, con algo de retraso, algunas de las funciones menos tratadas de Transloadit: mostramos de qué son capaces y te damos consejos útiles para ponerlas en marcha. Han pasado un par de meses desde nuestra última entrega de esta serie, así que retomemos donde lo dejamos y pongamos el foco en el Robot /document/convert.
El Robot /document/convert
Puedes usar el Robot /document/convert para procesar automáticamente tus documentos y convertirlos a un formato diferente.

Con tantas variedades de archivos disponibles, es inevitable que ciertas operaciones o procesos no admitan algunos tipos de archivo. En otros casos, un tipo de archivo concreto simplemente hace mejor el trabajo que otro. Ese es el caso del proceso de conversión que veremos hoy: convertir archivos SRT en archivos VTT. Consulta la documentación de /document/convert para ver los formatos de entrada y salida compatibles actualmente, incluida la conversión de PDF.
Los archivos SRT son los más comunes entre los muchos formatos de subtítulos que existen, pero carecen de algunas de las capacidades de los archivos VTT, como la posibilidad de usar código HTML5. Teniendo esto en cuenta, quizá quieras convertir tus archivos para aprovechar las funciones adicionales que ofrece el tipo de archivo VTT.
El Robot /document/convert se incorporó a la familia Robot de Transloadit en mayo de 2018.
Creación de la Assembly
Estas son las Assembly Instructions que utilicé:
assembly.add_step("converted", "/document/convert", {"format": "vtt"})
En el código anterior definimos las Assembly Instructions para que encajen en nuestro Template, de modo que el archivo utilizado pueda subirse para que Transloadit lo procese.
Para demostrar estas Assembly Instructions, solo tenemos que ejecutar el Template creado con Python que aparece más abajo, con las Assembly Instructions implementadas. Copia estas líneas de código para seguir el ejemplo:
# pip install pytransloadit
from transloadit import client
tl = client.Transloadit('YOUR_TRANSLOADIT_KEY', 'YOUR_TRANSLOADIT_SECRET')
assembly = tl.new_assembly()
assembly.add_file(open("subtitle.srt", "rb"))
assembly.add_step("converted", "/document/convert", {"format": "vtt"})
assembly_response = assembly.create(wait=True)
print(assembly_response.data['assembly_id'])
Después de ejecutar este código, ve a tus Assemblies, haz clic en la Assembly superior y deberías ver un resultado como este:

Los resultados
En la sección de resultados puedes elegir entre descargar tu nuevo archivo VTT o abrirlo en el navegador. De cualquier manera obtendrás el mismo resultado: ¡podrás comprobar que el nuevo archivo es efectivamente un archivo VTT!

Con esto llegamos al final de otra entrega de la serie Re-loadit. ¡Espero que estés deseando ver la siguiente!