Re-Loadit: aprimorando legendas com /document/convert

Na nossa série Re-loadit, fazemos uma apresentação tardia de alguns recursos menos abordados da Transloadit, mostrando do que eles são capazes e dando algumas dicas úteis para você colocá-los para funcionar. Já faz alguns meses desde o último episódio desta série, então vamos retomar de onde paramos e colocar os holofotes sobre o Robot /document/convert!
O Robot /document/convert
Você pode usar o Robot /document/convert para processar seus documentos automaticamente e convertê-los para um formato diferente.

Com tantas variedades de arquivos por aí, é inevitável que alguns tipos de arquivo não sejam compatíveis com determinadas operações ou processos. Em outros casos, um tipo de arquivo específico pode simplesmente cumprir a tarefa melhor do que outro. É o caso do processo de conversão que vamos ver hoje: converter arquivos SRT em arquivos VTT. Consulte a documentação do /document/convert para ver os formatos de entrada e saída compatíveis atualmente, incluindo a conversão de PDF.
Os arquivos SRT são os mais comuns entre os vários tipos de formato de legenda existentes, mas não têm alguns dos recursos dos arquivos VTT, como a possibilidade de usar código HTML5. Pensando nisso, talvez você queira converter seus arquivos para aproveitar os recursos adicionais que o tipo de arquivo VTT oferece.
O Robot /document/convert foi incorporado à família de Robots da Transloadit em maio de 2018.
Criando a Assembly
Estas são as Assembly Instructions que usei:
assembly.add_step("converted", "/document/convert", {"format": "vtt"})
No código acima, definimos as Assembly Instructions para se encaixarem no nosso Template, de modo que o arquivo usado possa ser enviado para a Transloadit processar.
Para demonstrar essas Assembly Instructions, basta executar o Template criado em Python abaixo com as Assembly Instructions implementadas. Copie estas linhas de código para acompanhar:
# 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'])
Depois de executar esse código, acesse suas Assemblies, clique na primeira Assembly da lista e você deverá ver um resultado como este:

Os resultados
Na seção de resultados, você pode baixar seu novo arquivo VTT ou abri-lo no navegador. Qualquer uma das opções leva ao mesmo resultado: você poderá confirmar que o novo arquivo é mesmo um arquivo VTT!

Chegamos ao fim de mais um episódio da série Re-loadit. Espero que você esteja ansioso pelo próximo!