API de Transcrição de Vídeo

Envie um arquivo de vídeo ou áudio e receba uma transcrição com identificação de locutor. A API suporta vídeos das principais plataformas e arquivos de vídeo/áudio enviados localmente, com suporte a configurações de idioma.

Fontes de Vídeo Suportadas

A API aceita URLs das seguintes plataformas: YouTube, Vimeo, Dailymotion, Kick, Twitch, TikTok, Facebook, Zoom, Rumble e outras.

Você também pode enviar arquivos de vídeo ou áudio locais. O upload local requer um plano Standard ou superior. Consulte a API de Upload para mais detalhes.

Fluxo de Trabalho

Envie uma tarefa de transcrição a partir de uma URL de vídeo
Consulte os resultados até que o status seja SUCCEEDED

Enviar Tarefa de Transcrição

POST https://wayinvideo-api.wayin.ai/api/v2/transcripts

Corpo da Requisição

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`video_url`	string	Sim	—	URL do vídeo/áudio de origem ou identificador do arquivo enviado
`source_lang`	string	Não	`null`	Idioma de origem do vídeo (consulte Idiomas Suportados). Quando `null`, o sistema detecta automaticamente o idioma original.
`target_lang`	string	Não	`null`	Idioma de destino para a transcrição (consulte Idiomas Suportados). Quando `null`, nenhuma tradução é aplicada. Se `target_lang` diferir do idioma original do vídeo, a transcrição será automaticamente traduzida para o idioma de destino.

Exemplo de Requisição

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/transcripts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "https://www.youtube.com/watch?v=example", "target_lang": "en"}'

Resposta

{
  "data": {
    "id": "trans_proj_001",
    "name": "sample project name",
    "status": "CREATED"
  }
}

Obter Resultados da Transcrição

GET https://wayinvideo-api.wayin.ai/api/v2/transcripts/results/{id}

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/transcripts/results/trans_proj_001 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

Resposta

{
  "data": {
    "status": "SUCCEEDED",
    "cost_usage": 27.0,
    "transcript": [
      {"text": "Welcome to today's presentation", "language": null, "start": 200, "end": 4500, "speaker": "Speaker 1"},
      {"text": "Thanks for coming", "language": null, "start": 5000, "end": 8200, "speaker": "Speaker 2"}
    ]
  }
}

Campos da Resposta

Campo	Tipo	Descrição
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`
`error_message`	string	Motivo do erro (somente quando `status` é `FAILED`)
`cost_usage`	number	API Units consumidas por esta requisição
`transcript`	array	Lista de segmentos de transcrição

Segmento de Transcrição

Campo	Tipo	Descrição
`text`	string	Texto transcrito
`language`	string \| null	Código do idioma detectado, ou `null` se não detectado
`start`	integer	Tempo de início em milissegundos
`end`	integer	Tempo de término em milissegundos
`speaker`	string	Rótulo do locutor (ex.: `"Speaker 1"`)