Video transkribieren

Die Transkription nutzt KI, um aus dem Audio eines Videos eine Textspur zu generieren. Die erzeugte Textspur wird dem Video als automatisch generierte Untertitelspur hinzugefügt und steht außerdem als reines Text-Transkript zur Verfügung.

KI-Funktionen erfordern einen Plan mit aktivierten KI-Funktionen. Der API-Token, den du verwendest, muss die Berechtigung update haben.

Transkription starten

Starte eine Transkription, indem du eine POST-Anfrage an den Endpoint /videos/:id/transcribe sendest. Das Feld language teilt der Transkriptions-Engine mit, in welcher Sprache das Audio vorliegt.

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

Parameter

Field	Required	Description
`language`	Ja	Sprache des Audios als BCP-47-Tag (`en`, `en-US`, `de`, `de-DE`, …).

Antwort

Die Transkription läuft asynchron. Die Anfrage kehrt sofort mit einem oder mehreren Transkriptions-Job-Datensätzen zurück. Videos, die länger als 3 Stunden sind, werden in mehrere Chunks aufgeteilt, sodass die Antwort mehr als einen Eintrag enthalten kann.


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

Sobald ein Job abgeschlossen ist, wird dem Video eine automatisch generierte Textspur hinzugefügt und das Transkript ausgefüllt. Frage den Endpoint Video abrufen regelmäßig ab und lies texttracks und transcriptions (oder autoTranscription), um das Ergebnis zu erhalten.

Beim Upload automatisch transkribieren

Du kannst die Transkription auch automatisch starten, sobald das Encoding abgeschlossen ist. Setze autoTranscribe: true und eine gültige language, wenn du ein Video erstellst. Dafür ist die Berechtigung create statt update erforderlich.


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