Text track übersetzen

Die Übersetzung nutzt KI, um aus einer bestehenden Textspur eine neue Textspur in einer anderen Sprache zu erstellen. Die Ausgangssprache wird der Quell-Textspur entnommen, daher musst du nur die Zielsprache angeben. Die neue Textspur behält denselben Typ (subtitles oder captions) wie die Quelle.

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

Textspur übersetzen

Übersetze eine Textspur, indem du eine POST-Anfrage an den Endpoint /videos/:id/texttracks/translate sendest.

CURL


curl -X POST https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks/translate \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"texttrackId": "[TEXTTRACK_ID]", "targetLanguage": "de"}'

JavaScript / Node.js


const data = {
texttrackId: "[TEXTTRACK_ID]",
targetLanguage: "de" // BCP-47 language tag, e.g. "de", "fr", "es"
};
 
const response = await fetch('https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks/translate', {
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 = [
"texttrackId" => "[TEXTTRACK_ID]",
"targetLanguage" => "de" // BCP-47 language tag, e.g. "de", "fr", "es"
];
 
$response = $client->request('POST', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks/translate', [
'body' => json_encode($data),
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN',
  'Content-Type' => 'application/json'
]
]);
 
$result = json_decode($response->getBody(), true);

Parameter

Field	Required	Description
`texttrackId`	Ja	ID der Quell-Textspur des Videos.
`targetLanguage`	Ja	Zielsprache als BCP-47-Tag (`de`, `fr`, `es`, …).

Sowohl die Ausgangs- als auch die Zielsprache müssen für die Übersetzung unterstützt werden. Ein Video kann nicht zwei Textspuren mit derselben Sprache und demselben Typ haben, daher kannst du nicht in eine Sprache übersetzen, die für diesen Typ bereits existiert.

Antwort

Das neu erstellte Textspur-Objekt.


{
  "texttrack": {
    "id": string,
    "language": string,
    "type": "subtitles" | "captions",
    "filename": string,
    "url": string
  }
}