Transcrever um vídeo

A transcrição usa IA para gerar uma faixa de texto a partir do áudio de um vídeo. A faixa de texto gerada é adicionada 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. O token de API que usas tem de ter a permissão 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 tag BCP-47 (`en`, `en-US`, `de`, `de-DE`, …).

Resposta

A transcrição é executada de forma assíncrona. O pedido devolve de imediato um ou mais registos de tarefa de transcrição. Vídeos com mais de 3 horas são divididos em vários chunks, pelo que 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, é adicionada ao vídeo uma faixa de texto gerada automaticamente e a transcrição é preenchida. Consulta periodicamente o endpoint obter vídeo e lê texttracks e transcriptions (ou autoTranscription) para obter o resultado.

Transcrever automaticamente ao carregar

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


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