API de transcrição de Reels do Facebook

Transforme Reels e vídeos públicos do Facebook em texto pelo seu backend. Envie a URL do Facebook, consulte a tarefa assíncrona e use a transcrição concluída e seus segmentos com marcação de tempo no seu aplicativo.

Integre a transcrição de vídeos do Facebook às operações de publicação

Um vídeo público do Facebook pode entrar em um processo de revisão, arquivamento ou acessibilidade usando o mesmo contrato de API das outras fontes compatíveis. Seu sistema mantém um único modelo de autenticação e um único esquema de transcrição, sem precisar manter um serviço específico para o Facebook.

Escolha a URL correta para um Reel ou vídeo público do Facebook

Reels: envie a URL facebook.com/reel/{id} copiada do Reel público.
Publicações com vídeo: links públicos facebook.com/.../videos/{id} identificam vídeos comuns do Facebook publicados fora da área de Reels.
Links curtos de compartilhamento: links fb.watch podem funcionar quando ainda redirecionam para um vídeo público que não exige uma conta.

Início rápido: coloque a transcrição de um Reel ou vídeo público do Facebook 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.facebook.com/reel/123456789012345",
    "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 Reel ou vídeo público do Facebook

Arquivos de mídia: permita pesquisar coleções autorizadas de vídeos públicos pelas palavras faladas em cada clipe.
Revisão de campanhas: converta Reels e vídeos aprovados em texto para processos de marca, jurídicos ou de localização.
Operações de conteúdo: crie texto-fonte alinhado ao tempo para resumos, trechos e legendas revisados por uma pessoa.

Links compatíveis e requisitos de acesso

O resolvedor de links aceita URLs compatíveis de Reels e vídeos públicos do Facebook que estejam visíveis sem uma conta do Facebook.

O Reel ou vídeo precisa ser público e acessível sem login.
Publicações privadas, grupos restritos, mídias removidas e vídeos protegidos por login não podem ser importados.
Quando um vídeo incorporado estiver hospedado em outra plataforma, envie a URL da mídia compatível na plataforma de origem, se possí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 Reel ou vídeo público do Facebook

Diferencie publicações públicas de Páginas públicas: uma Página pública não garante que todos os vídeos estejam visíveis sem login. Teste a URL específica do vídeo.
Evite URLs de grupos e feeds: publicações de grupos restritos, páginas de feed e URLs genéricas de perfil não oferecem uma fonte de vídeo que possa ser recuperada publicamente.
Use o host original: quando uma publicação do Facebook incorporar um vídeo externo, envie a URL do YouTube ou a URL direta da mídia original.

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 aceita Reels e vídeos do Facebook?

Ela aceita URLs compatíveis de Reels e vídeos públicos do Facebook que abrem sem login.

Publicações privadas ou vídeos de grupos restritos funcionam?

Não. A mídia precisa ser acessível publicamente sem login no Facebook.

A transcrição consegue distinguir os locutores?

A diarização de locutores está disponível no plano Pro ao definir speaker_diarization como true.