API de transcrição do TikTok: converta vídeo em texto

Coloque vídeos públicos do TikTok na fila de transcrição por meio de um aplicativo ou backend. O Fast Transcriber aceita a URL do vídeo, processa-a de forma assíncrona e retorna texto estruturado e segmentos com marcação de tempo.

Adicione a conversão de TikTok em texto a um produto ou fluxo de conteúdo

Em vez de pedir que usuários baixem um vídeo público do TikTok e depois enviem o arquivo novamente, envie a URL compatível diretamente. A API atribui um identificador a cada tarefa e retorna um formato previsível para filas, bancos de dados, índices de pesquisa e sistemas de IA posteriores.

Escolha a URL correta para um vídeo público do TikTok

URLs canônicas de vídeos: prefira tiktok.com/@creator/video/{id}, que aponta para um único vídeo e facilita o registro e a remoção de duplicatas.
Links curtos copiados: links de compartilhamento vm.tiktok.com e vt.tiktok.com podem ser enviados enquanto o redirecionamento ainda levar a um vídeo público.
Fontes que não são vídeos: perfis de criadores, páginas de hashtags, páginas de pesquisa e coleções não identificam uma única fonte para transcrição.

Início rápido: coloque a transcrição de um vídeo público do TikTok 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.tiktok.com/@creator/video/1234567890123456789",
    "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 público do TikTok

Propostas aprovadas de criadores: converta vídeos de campanha em texto pesquisável para revisão e relatórios.
Pesquisa de tendências: analise a linguagem falada em um conjunto autorizado de vídeos públicos sem transcrever cada clipe manualmente.
Flux de conteúdo acessível: use segmentos com marcação de tempo como ponto de partida para criar legendas e alternativas em texto revisadas por uma pessoa.

Links compatíveis e requisitos de acesso

Envie a URL de um vídeo público do TikTok que abra sem login. O resolvedor recupera a mídia antes do início da transcrição.

O vídeo precisa ser público e continuar disponível na URL enviada.
Vídeos privados, exclusivos para amigos, com restrição de idade, removidos ou protegidos por login não podem ser importados.
Envie um único vídeo por tarefa de transcrição e respeite os direitos do criador e as regras aplicáveis da plataforma.

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 público do TikTok

Verifique a configuração de público: uma publicação exclusiva para amigos ou privada pode parecer válida para o criador conectado, mas continuar inacessível ao fluxo de transcrição.
Considere as restrições: limites de idade, região ou login podem impedir a recuperação da mídia mesmo quando a URL está bem formada.
Planeje falhas de vídeos removidos: um vídeo removido ou moderado pode desaparecer entre o envio e o processamento; sempre trate um resultado de falha ao consultar a tarefa.

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

Vídeos privados do TikTok funcionam?

Não. A URL precisa ser acessível publicamente sem login no TikTok.

Meu aplicativo precisa baixar o vídeo do TikTok primeiro?

Não para uma URL pública compatível. Envie-a diretamente em source_url e o Fast Transcriber resolverá o link.

A API pode retornar marcações de tempo?

Sim. As tarefas concluídas contêm o texto da transcrição e segmentos com marcação de tempo, conforme os limites do plano da conta autenticada.