Text track übersetzen

Die Übersetzung nutzt KI, um aus einem bestehenden Text track einen neuen Text track in einer anderen Sprache zu erstellen. Die Ausgangssprache wird dem Quell-Text-track entnommen, daher musst du nur die Zielsprache angeben. Der neue Text track 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.

Text track übersetzen

Übersetze einen Text track, 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 des Quell-Text-tracks 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 Text tracks 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 Text-track-Objekt.


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