API de transcrição de URLs de vídeos públicos

Use um único endpoint para colocar na fila links públicos compatíveis de vídeos sociais, mídias do Google Drive e URLs diretas de arquivos de áudio ou vídeo. O Fast Transcriber resolve a mídia, retorna 202 Accepted e disponibiliza a transcrição concluída por uma URL de consulta.

Um único contrato de API para fontes públicas de mídia compatíveis

Um único fluxo source_url padroniza o código de importação para YouTube, Instagram, TikTok, Facebook, Google Drive e mídias públicas diretas. Sua integração mantém um único modelo de tarefa e um único esquema de transcrição enquanto o Fast Transcriber cuida da resolução e transcrição da fonte.

Escolha a URL correta para uma URL de vídeo público

Páginas de vídeos sociais: use a URL canônica de um único vídeo compatível do YouTube, Instagram, TikTok ou Facebook, não a URL de um perfil, feed ou coleção.
Mídias do Google Drive: use o link de compartilhamento de um arquivo de áudio ou vídeo que permita download sem autenticação do Google.
Arquivos diretos de mídia: a própria resposta precisa conter áudio ou vídeo, de preferência com uma extensão reconhecível ou um cabeçalho Content-Type de mídia.

Início rápido: coloque a transcrição de uma URL de vídeo público 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://cdn.example.com/media/interview.mp4",
    "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 uma URL de vídeo público

Importação unificada: aceite várias fontes públicas de mídia compatíveis sem exibir uma interface de transcrição diferente para cada uma.
Pesquisa e descoberta: indexe o texto da transcrição e preserve os segmentos que apontam para trechos específicos.
Fluxos de automação: coloque mídias autorizadas na fila, acompanhe o status das tarefas e encaminhe o texto concluído para armazenamento ou processamento posterior.

Links compatíveis e requisitos de acesso

O fluxo atual de links públicos aceita YouTube, Instagram, TikTok, Facebook, mídias do Google Drive e URLs diretas de arquivos públicos de áudio ou vídeo.

A URL precisa usar HTTP ou HTTPS e levar a uma mídia compatível sem login, cookie ou token privado.
Artigos e páginas comuns da web não são convertidos em texto: a URL precisa apontar para uma mídia de áudio ou vídeo compatível.
Mídias privadas ou restritas devem usar um fluxo autorizado de envio direto, não uma tarefa de URL pública.

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 uma URL de vídeo público

Valide antes de colocar na fila: recuse entradas vazias e que não usam HTTP na interface e deixe a API retornar invalid_source_url para URLs de origem malformadas.
Mantenha as URLs disponíveis: links assinados com prazo de validade precisam permanecer válidos por tempo suficiente para que o fluxo assíncrono resolva e baixe a mídia.
Diferencie a entrada na fila da recuperação: 202 confirma apenas que a tarefa foi criada. Mostre data.error se uma consulta posterior informar que a fonte está inacessível ou não é compatível.

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

A API pode transcrever qualquer URL de página da web?

Não. Ela transcreve a fala de links de mídia compatíveis e não extrai texto de páginas comuns da web.

Posso enviar a URL direta de uma mídia?

Sim, quando for a URL pública de um arquivo de áudio ou vídeo acessível sem autenticação.

O que fazer se a fonte exigir login ou um token privado?

Use o fluxo de envio direto, desde que você tenha autorização para processar a mídia.