Trascrivere un video

La trascrizione usa l’IA per generare una traccia di testo dall’audio di un video. La traccia di testo generata viene aggiunta al video come traccia di sottotitoli generata automaticamente ed è disponibile anche come trascrizione in testo semplice.

Le funzioni IA richiedono un piano con le funzioni IA abilitate. Il token API che usi deve avere il permesso update.

Avviare la trascrizione

Avvia una trascrizione inviando una richiesta POST all’endpoint /videos/:id/transcribe. Il campo language indica al motore di trascrizione la lingua dell’audio.

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);

Parametri

Campo	Obbligatorio	Descrizione
`language`	Sì	Lingua dell’audio come tag BCP-47 (`en`, `en-US`, `de`, `de-DE`, …).

Risposta

La trascrizione viene eseguita in modo asincrono. La richiesta restituisce immediatamente uno o più record di job di trascrizione. I video più lunghi di 3 ore vengono suddivisi in più chunk, quindi la risposta può contenere più di una voce.


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

Quando un job viene completato, una traccia di testo generata automaticamente viene aggiunta al video e la trascrizione viene compilata. Interroga periodicamente l’endpoint ottenere video e leggi texttracks e transcriptions (oppure autoTranscription) per recuperare il risultato.

Trascrivere automaticamente al caricamento

Puoi anche avviare la trascrizione automaticamente al termine della codifica. Imposta autoTranscribe: true e una language valida quando crei un video. Questo richiede il permesso create invece di update.


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