Como baixar a transcrição do YouTube
Esse caminho serve para guardar, editar ou importar o texto em outra ferramenta. Você baixa a transcrição ou as legendas, não uma cópia do vídeo. Se a transcrição já estiver pronta no painel, abra-a direto em vez de enviar o link de novo.
Abra ou crie a transcrição
Entre no painel, cole o link do vídeo e espere o processamento terminar. Aceitamos watch, youtu.be, Shorts e embed. Um canal ou uma playlist não identifica um vídeo específico.
Escolha onde vai usar o texto
Para ler, escolha TXT. Para um editor de legendas, SRT. Para uma faixa de vídeo em HTML, VTT. Para seu código, JSON. Assim você mantém os dados de que a próxima ferramenta precisa.
Baixe e abra na ferramenta de destino
Escolha o formato no menu de download do painel. Abra o arquivo, confira os caracteres e compare as marcações de tempo com o vídeo original antes de usá-lo.
Qual formato vale a pena baixar?
TXT facilita a leitura e a edição em um documento. Para legendas ou código, você precisa também da estrutura e dos tempos. Baixe o formato que sua ferramenta aceita; trocar só a extensão do arquivo não faz a conversão.
Você pode baixar vários formatos da mesma transcrição sem pagar por novos minutos. Se sua aplicação precisar de outro formato mais tarde, guarde o ID da transcrição.
| Formato | Quando usar | O que ele mantém |
|---|---|---|
| TXT | Leitura, edição e notas | Texto da transcrição. Pela API, também pode incluir marcações de tempo. |
| SRT | Editores e importação de legendas | Entradas numeradas com início e fim. |
| VTT | Faixas de legenda em vídeo HTML | Tempos WebVTT e tags de voz se você pediu identificação de falantes. |
| JSON | Aplicações e arquivos estruturados | Segmentos, tempos, idioma e campos de falantes disponíveis. |
Confira as legendas junto da versão final do vídeo
SRT e VTT seguem a linha do tempo do vídeo enviado. Se você cortar a abertura, reorganizar cenas ou mudar a velocidade, ajuste as marcações. Mesmo com as palavras certas, as legendas podem ficar fora de sincronia depois da edição.
Quando usamos legendas do YouTube, mantemos o texto publicado, inclusive indicações como [Music]. Quando usamos IA, criamos uma nova transcrição do áudio. A transcrição registra a fonte usada para você distinguir os dois casos ao organizar seus arquivos.
O arquivo de legenda não define fonte, posição ou animação do texto no vídeo. Você ajusta isso no editor ou player. Antes de publicar para acessibilidade, confira também os sons relevantes e a identificação de falantes no contexto.
Copie o texto sem perder a referência do vídeo
Para uma citação curta, copiar do painel pode ser mais prático que baixar. Guarde o link e a marcação de tempo junto da frase. Assim você consegue conferir as palavras na gravação mesmo depois de reorganizar suas notas.
Para um texto longo, mantenha o arquivo original e faça as correções em outra cópia. Ajuste erros de reconhecimento e parágrafos para facilitar a leitura. Se reescrever uma explicação, apresente-a como suas notas, não como uma citação literal. Tanto legendas automáticas quanto transcrição com IA podem precisar de revisão.
Escolha um nome de arquivo com o assunto e sua data de gravação ou revisão. O transcript1 guarda a transcrição até você excluí-la. O download é a cópia que você organiza no seu próprio arquivo.
Baixe o arquivo pela API
Se sua aplicação já tem o ID da transcrição concluída, consulte GET /v1/transcriptions/:id no formato desejado. Para texto com marcações, use format=text e timestamps=true. Para legendas, format=srt ou format=vtt. A referência de download lista as opções.
O exemplo salva um SRT local. Antes de gravar a resposta em um arquivo, confira se a transcrição está concluída. Enquanto ela processa, a API retorna um JSON de status, não as legendas. Salvar esse JSON com extensão .srt causa um erro de importação que parece ser do arquivo de legenda.
curl "https://api.transcript1.com/v1/transcriptions/TRANSCRIPTION_ID?format=srt" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-o transcript.srt