Transcrever um vídeo

A transcrição usa IA para gerar um text track a partir do áudio de um vídeo. O text track gerado é adicionado ao vídeo como uma faixa de legendas gerada automaticamente e fica também disponível como transcrição em texto simples.

As funções de IA exigem um plano com funções de IA ativadas. A Chave API que usas tem de ter a permissão videos.update.

Iniciar a transcrição

Inicia uma transcrição enviando um pedido POST para o endpoint /videos/:id/transcribe. O campo language indica ao motor de transcrição em que idioma está o áudio.

CURL


curl -X POST https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"language": "en"}'

JavaScript / Node.js


const data = {
language: "en" // BCP-47 language tag, e.g. "en", "en-US", "de", "de-DE"
};
 
const response = await fetch('https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe', {
method: 'POST',
body: JSON.stringify(data),
headers: {
  'Authorization': 'Bearer YOUR_TOKEN',
  'Content-Type': 'application/json'
}
});
 
const result = await response.json();

PHP


$client = new GuzzleHttp\Client();
$data = [
"language" => "en" // BCP-47 language tag, e.g. "en", "en-US", "de", "de-DE"
];
 
$response = $client->request('POST', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/transcribe', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);
 
$result = json_decode($response->getBody(), true);

Parâmetros

Campo	Obrigatório	Descrição
`language`	Sim	Idioma do áudio como etiqueta BCP-47 (`en`, `en-US`, `de`, `de-DE`, …).

Resposta

A transcrição corre de forma assíncrona. O pedido devolve imediatamente um ou mais registos de tarefas de transcrição. Vídeos com mais de 3 horas são divididos em vários chunks, por isso a resposta pode conter mais do que uma entrada.


[
  {
    "id": string,
    "status": "QUEUED" | "IN_PROGRESS" | "COMPLETED" | "FAILED" | "NONE",
    "language": string,
    "jobName": string
  }
]

Quando uma tarefa termina, um text track gerado automaticamente é adicionado ao vídeo e a transcrição é preenchida. Faz polling ao endpoint obter vídeo e lê texttracks e transcriptions (ou autoTranscription) para obteres o resultado.

Transcrever automaticamente após a codificação

Também podes iniciar a transcrição automaticamente quando a codificação termina. Define autoTranscribe: true e um language válido quando crias um vídeo. Isto exige a permissão videos.create em vez de videos.update.


{
  "title": "Your video title",
  "language": "en",
  "autoTranscribe": true
}