Transcrição por IA
Toda gravação concluída é transcrita automaticamente — timestamps em nível de palavra, três formatos de saída, detecção automática de idioma.
Transcrição por IA
O VIDTREO AI transcreve automaticamente toda gravação concluída. Não há API de transcrição para chamar nem áudio para extrair — quando o upload de um vídeo termina em um ambiente com a transcrição habilitada, o pipeline é executado sozinho e notifica seus sistemas via webhooks quando a transcrição estiver pronta.
Gravação concluída
→ Áudio extraído do vídeo
→ Transcrição com timestamps em nível de palavra
→ Idioma detectado automaticamente
→ Transcrição armazenada em três formatos (VTT, JSON, TXT)
→ webhook transcriptions.transcription.completed disparadoHabilitando a Transcrição
A transcrição é configurada por ambiente:
Faça login no VIDTREO Dashboard
Abra seu ambiente e vá para Configurações → Geral
Ative a Transcrição por IA
A partir desse momento, toda gravação concluída no ambiente é transcrita automaticamente. Vídeos enviados enquanto a opção estava desativada não são processados retroativamente.
O idioma é detectado automaticamente — não há parâmetro de idioma. Os usuários podem gravar em espanhol, português, inglês ou qualquer outro idioma falado, e a transcrição volta nesse mesmo idioma.
Formatos de Saída
Cada transcrição gera três arquivos:
| Formato | Tipo de conteúdo | Criado para |
|---|---|---|
vtt | text/vtt | Legendas WebVTT — insira diretamente em um elemento <track> para reprodução acessível |
json | application/json | Segmentos em nível de palavra com horários start/end — busca, interfaces de pular-para-o-momento, alimentação de LLMs |
txt | text/plain | Transcrição em texto puro — indexação de texto completo, resumos, arquivamento |
O formato JSON é um array de segmentos em nível de palavra:
[
{ "word": "welcome", "start": 1.02, "end": 1.38 },
{ "word": "to", "start": 1.38, "end": 1.5 },
{ "word": "the", "start": 1.5, "end": 1.62 }
]Ciclo de Vida da Transcrição
| Status | Significado |
|---|---|
PENDING | Na fila, aguardando processamento |
PROCESSING | Extração de áudio e transcrição em andamento |
COMPLETED | Os arquivos de transcrição estão disponíveis |
FAILED | O processamento falhou — pode ser reprocessado pelo dashboard |
SKIPPED | O vídeo não tem faixa de áudio — nada para transcrever |
Um vídeo gravado sem microfone (por exemplo, uma gravação de tela sem áudio) resulta em SKIPPED, não em FAILED. Trate ambos os status se seu fluxo de trabalho espera uma transcrição para todo vídeo.
Buscando uma Transcrição via API
Recupere a transcrição de qualquer vídeo usando sua API key (requer a permissão get_video):
curl https://core.vidtreo.com/api/v1/videos/{videoId}/transcription \
-H "Authorization: Bearer vt_live_xxxxxxxxxxxxxxxxxxxx"Resposta:
{
"id": "b7e2...",
"videoId": "vid_...",
"environmentId": "env_...",
"status": "COMPLETED",
"language": "en",
"wordCount": 812,
"duration": 294.5,
"files": {
"vtt": { "url": "https://...", "expiresAt": "...", "contentType": "text/vtt" },
"json": { "url": "https://...", "expiresAt": "...", "contentType": "application/json" },
"txt": { "url": "https://...", "expiresAt": "...", "contentType": "text/plain" }
},
"createdAt": "2026-08-03T14:17:00.000Z",
"completedAt": "2026-08-03T14:22:07.000Z"
}files é null até que status seja COMPLETED.
As URLs dos arquivos são pré-assinadas (presigned) e expiram em 5 minutos após serem geradas. Busque o conteúdo assim que recebê-lo, armazene o que for necessário do seu lado e solicite novas URLs a este endpoint sempre que precisar dos arquivos novamente. Nunca persista as URLs em si.
Recebendo Notificações
Fazer polling neste endpoint funciona, mas a integração pretendida é orientada a eventos: inscreva um endpoint de webhook no evento transcriptions.transcription.completed e receba os arquivos de transcrição — além dos seus próprios metadados — no momento em que o processamento terminar.
Veja Webhooks para o formato do payload, verificação de assinatura e garantias de entrega.