API de transcrição do YouTube para vídeos e Shorts

Integre a conversão de YouTube em texto a bases de conhecimento, produtos educacionais e fluxos de mídia. Envie a URL de um vídeo público, Short ou link youtu.be e consulte o local da tarefa para obter resultados estruturados.

Crie texto pesquisável a partir de mídias do YouTube

O Fast Transcriber gera uma transcrição usando seu próprio fluxo de processamento de mídia e reconhecimento de fala, por isso seu aplicativo não precisa depender de uma faixa de legendas fornecida pelo criador. O texto e os segmentos concluídos usam o mesmo formato de todas as outras tarefas da API.

Escolha a URL correta para um vídeo ou Short público do YouTube

Vídeos padrão: youtube.com/watch?v={video-id} é a forma canônica de um vídeo público comum.
Shorts: youtube.com/shorts/{video-id} aponta para um Short público sem exigir que a URL seja convertida primeiro em um link watch.
Links curtos de compartilhamento: links youtu.be/{video-id} usam o mesmo fluxo depois que o redirecionamento é resolvido. Envie um único vídeo, não uma página de playlist.

Início rápido: coloque a transcrição de um vídeo ou Short público do YouTube na fila

Crie uma chave de API do Fast Transcriber e armazene-a em uma variável de ambiente no servidor. Envie a URL pública da mídia em source_url. Nunca exponha a chave Bearer no código do navegador nem a envie para o repositório do código-fonte.

curl --request POST https://fast-transcriber.com/api/v1/transcriptions \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "speaker_diarization": false
  }'

Uma solicitação válida retorna 202 Accepted. Isso significa que a tarefa entrou na fila, não que a fonte foi recuperada com sucesso. Leia o cabeçalho de resposta Location, atribua esse caminho a LOCATION_PATH e consulte-o até que o status da tarefa seja completed ou failed.

LOCATION_PATH="/api/v1/transcriptions/95c3fdd8-..."
curl --request GET "https://fast-transcriber.com$LOCATION_PATH" \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN"

Pronto para enviar esta solicitação? Crie uma chave de API ou consulte todos os endpoints na documentação da API.

Trabalhe com texto e segmentos com marcação de tempo

As tarefas concluídas contêm o texto da transcrição e os segmentos com marcação de tempo disponíveis conforme os limites do plano da conta autenticada. O mesmo formato de resposta permite que um aplicativo indexe um vídeo, acesse trechos citados, crie resumos ou encaminhe a transcrição para uma pesquisa autorizada ou um fluxo RAG.

{
  "data": {
    "id": "95c3fdd8-...",
    "filename": "video-source.mp4",
    "status": "completed",
    "duration_seconds": 84,
    "text": "Texto completo da transcrição...",
    "segments": [
      { "start": 0, "end": 3.8, "text": "Primeiro segmento..." }
    ]
  }
}

Defina speaker_diarization como true quando precisar identificar os locutores. A diarização exige uma conta Pro e usa os mesmos limites do aplicativo web.

O que os desenvolvedores criam com transcrições de um vídeo ou Short público do YouTube

Bases de conhecimento: indexe videotecas educacionais ou empresariais autorizadas pelo conteúdo falado.
Ferramentas de pesquisa: pesquise e cite trechos relevantes usando os tempos dos segmentos.
Fluxos de publicação: transforme seus próprios vídeos em rascunhos de artigos, notas de programa, capítulos ou textos acessíveis para revisão.

Links compatíveis e requisitos de acesso

Vídeos públicos do YouTube, Shorts e links youtu.be compatíveis podem ser enviados em source_url.

O vídeo precisa ser público, estar disponível e ser acessível sem login.
Vídeos privados, exclusivos para membros, removidos, com restrição de idade e transmissões ao vivo em andamento não podem ser importados.
Envie a URL canônica do vídeo, Short ou link youtu.be e trate no seu aplicativo os erros de mídia inacessível.

Se uma gravação for privada e você tiver autorização para processá-la, recupere a mídia pelo seu próprio fluxo autenticado e use a API de envio direto de arquivos de áudio e vídeo.

Resolva problemas ao importar um vídeo ou Short público do YouTube

Exclua transmissões ao vivo em andamento: aguarde o fim da transmissão e a disponibilização de uma gravação pública antes de colocar a transcrição na fila.
Teste a reprodução sem uma conta: vídeos exclusivos para membros, privados, com restrição de idade e alguns vídeos limitados por região não podem ser recuperados por um fluxo de links públicos.
Guarde o identificador do vídeo: esse identificador estável ajuda seu aplicativo a remover duplicatas entre as variantes watch, Shorts e youtu.be que apontam para a mesma mídia.

Planeje o tratamento de erros assíncronos

Uma integração em produção deve tratar fontes inválidas ou inacessíveis, falhas de autenticação, limites da conta e falhas temporárias de processamento. Erros HTTP imediatos usam o envelope {"error":{"code":"...","message":"..."}}. Ao consultar a tarefa, uma fonte que entrou na fila pode retornar data.status como failed, com detalhes em data.error. Não tente novamente indefinidamente com mídias privadas, removidas ou protegidas por login; mostre uma mensagem clara ou ofereça o envio autorizado do arquivo.

Perguntas frequentes

Quais formatos de URL do YouTube funcionam?

Vídeos públicos, Shorts e links youtu.be compatíveis usam o mesmo resolvedor da ferramenta do Fast Transcriber no navegador.

A API pode acessar conteúdo privado do YouTube?

Não. Fontes enviadas por URL precisam ser acessíveis publicamente. Para uma mídia privada que você tenha autorização para processar, use o envio direto autorizado.

Por que o endpoint retorna 202?

A transcrição é assíncrona. Use o cabeçalho Location para recuperar o status da tarefa e depois o resultado final.