API de transcrição do Instagram para Reels

Adicione a transcrição de vídeos do Instagram a um backend com um único endpoint REST assíncrono. Envie a URL de um Reel ou vídeo público, receba o local de consulta e recupere o texto estruturado da transcrição com segmentos marcados no tempo.

Transcreva mídias do Instagram sem manter seu próprio downloader

A forma de importar mídias do Instagram muda ao longo do tempo e pode exigir muita manutenção. O Fast Transcriber cuida da resolução de links públicos compatíveis e do fluxo de reconhecimento de fala por meio de uma única solicitação autenticada, para que seu aplicativo possa se concentrar na transcrição e no processo criado em torno dela.

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

Reels: use a URL instagram.com/reel/{shortcode} ou instagram.com/reels/{shortcode} copiada de um Reel público.
Publicações com vídeo: uma URL instagram.com/p/{shortcode} funciona quando a publicação contém um único vídeo público; uma publicação composta apenas por imagens não tem fala para transcrever.
Links de vídeos antigos: links instagram.com/tv/{shortcode} podem ser enviados se o vídeo ainda estiver disponível publicamente.

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

Arquivos de criadores: mantenha texto pesquisável junto aos Reels públicos que seu aplicativo tem autorização para indexar.
Revisão de conteúdo: encaminhe afirmações faladas, mensagens de campanha ou propostas de criadores para um processo de revisão baseado em texto.
Reaproveitamento de conteúdo: transforme a fala de vídeos aprovados em briefings, legendas, citações ou rascunhos, preservando as marcações de tempo.

Links compatíveis e requisitos de acesso

A API aceita URLs de Reels públicos do Instagram e de publicações com um único vídeo que o resolvedor de links consiga abrir sem uma sessão do Instagram.

O Reel ou a publicação com vídeo precisa ser público e acessível sem login.
Perfis privados, publicações para Amigos Próximos, mídias removidas e bloqueios de login não podem ser importados por URL.
A disponibilidade e os limites de requisição do Instagram podem bloquear ocasionalmente até uma URL pública; trate a falha da tarefa e ofereça o envio autorizado do arquivo.
Para uma publicação em carrossel, use o link direto de uma publicação com um único vídeo ou envie o vídeo específico que você tem autorização para processar.

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 Instagram

Teste o acesso sem login: abra o Reel ou a publicação específica em uma janela anônima. Se uma página de login aparecer, normalmente o fluxo de transcrição também não conseguirá recuperar a mídia.
Trate carrosséis explicitamente: não presuma que a URL de uma publicação seleciona cada item. Quando um carrossel tiver várias mídias, envie o vídeo autorizado específico.
Trate falhas de acesso à plataforma: um limite de requisições ou uma verificação de acesso do Instagram pode fazer a tarefa falhar depois de entrar na fila. Dê um intervalo entre as tentativas e ofereça o envio direto em vez de tentar indefinidamente.

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 links do Instagram a API pode transcrever?

Você pode enviar em source_url URLs de Reels públicos do Instagram e de publicações com um único vídeo que abram sem login.

A API pode transcrever conteúdo privado do Instagram?

Não. Se você tiver autorização para usar uma mídia privada, baixe-a pelo seu próprio fluxo autenticado e use a API de envio direto.

A solicitação POST retorna a transcrição concluída?

Não. Ela retorna 202 Accepted e um cabeçalho Location. A aceitação significa que a tarefa entrou na fila, não que a mídia foi recuperada; consulte essa URL até a tarefa ser concluída ou falhar.