Volte à fala certa com uma marcação por linha
Peça format=text com timestamps=true. Se a transcrição tiver identificação de falantes, os rótulos também aparecem. Veja as opções na consulta de transcrição.
Esse formato funciona bem para leitura, notas e conferência de citações. Guarde o link ou o nome do arquivo junto do texto: um tempo como 00:12:40 só ajuda se você souber de qual gravação ele veio. O texto do exemplo abaixo apenas ilustra o formato.
No JSON, start e end são segundos contados a partir do início da mídia, não horários do dia nem datas. Use esses valores para levar o player ao trecho ou manter uma referência nas suas notas.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text×tamps=true" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
[00:00:00] Place the microphone near the speaker.
[00:00:04] Record a short test before the interview.Quando escolher SRT e quando criar um arquivo VTT
SRT traz entradas numeradas com início e fim. WebVTT começa com WEBVTT e funciona no elemento track do HTML. Quando a transcrição estiver concluída, peça format=srt ou format=vtt e salve a resposta.
Escolha o que a ferramenta de destino aceita. SRT é comum em editores de vídeo e importações de legendas. WebVTT atende às faixas de legenda de vídeo em HTML. Nenhum deles aplica o texto à imagem do vídeo nem copia o estilo de uma rede social: o editor ou player define a aparência.
Os formatos também escrevem os tempos de formas diferentes. SRT separa os milissegundos com vírgula; WebVTT, com ponto. Não basta renomear a extensão. Consulte a mesma transcrição no formato desejado, sem gastar minutos de novo.
1
00:00:00,000 --> 00:00:04,200
Place the microphone near the speaker.
2
00:00:04,200 --> 00:00:09,800
Record a short test before the interview.Use o JSON para destacar palavras ou marcar cortes
Inclua include=words ao consultar o JSON para receber os tempos por palavra, quando disponíveis. Se a fonte não trouxer esses dados, words será null. Confira os campos na referência da API.
A transcrição com IA traz início, fim e confiança por palavra. Nas legendas automáticas do YouTube, o início está disponível e o fim é calculado pelo início da palavra seguinte. Legendas do criador no YouTube e todas as legendas de outras plataformas não têm esses tempos, mesmo quando geradas automaticamente. Isso inclui X, TikTok e Bluesky; no X, transcript_source é x_captions.
Prepare sua interface para usar os tempos dos segmentos quando words for null. Para cortar um clipe, ouça o entorno do ponto marcado e confira se não cortou o começo de um som. Para legendas com palavras destacadas, agrupe o texto em frases legíveis e teste no tamanho de tela em que ele será visto.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?include=words" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"Teste o arquivo antes de integrar ou publicar
Espere status=completed antes de baixar SRT, VTT ou texto. Enquanto a transcrição estiver em andamento, a API retorna o objeto JSON com o status. Se o player recusar o arquivo, confira primeiro se você não salvou esse JSON com extensão .srt.
As legendas seguem o início e a duração da mídia enviada. Se você recortar um clipe de uma parte mais adiante, precisará ajustar os tempos. Ao reaproveitar um vídeo, guarde o intervalo escolhido e alinhe as legendas depois do corte final.
Abra o arquivo no player de destino e assista em velocidade normal. Confira o comprimento das linhas, o tempo de leitura e a apresentação dos falantes. Para acessibilidade, revise também sons relevantes e contexto visual: a revisão de legendas vai além da sintaxe do arquivo.
Guarde o ID da transcrição com os dados do download. Se depois precisar de VTT em vez de SRT, ou JSON em vez de texto, consulte o mesmo ID. Não é necessário enviar a mídia de novo.