Translate a text track

Translation uses AI to create a new text track in another language from an existing text track. The source language is taken from the source text track, so you only need to provide the target language. The new text track keeps the same type (subtitles or captions) as the source.

AI features require a plan with AI features enabled. The API token that you use must have the update permission.

Translate a text track

Translate a text track by sending a POST request to the /videos/:id/texttracks/translate endpoint.

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

Parameters

Field	Required	Description
`texttrackId`	Yes	ID of the source text track on the video.
`targetLanguage`	Yes	Target language as a BCP-47 tag (`de`, `fr`, `es`, …).

Both the source and target language must be supported for translation. A video cannot have two text tracks with the same language and type, so you cannot translate into a language that already exists for that type.

Response

The newly created text track object.


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