Traduire un Text track

La traduction utilise l’IA pour créer un nouveau Text track dans une autre langue à partir d’un Text track existant. La langue source est reprise du Text track source, tu n’as donc qu’à fournir la langue cible. Le nouveau Text track conserve le même type (subtitles ou captions) que la source.

Les fonctions IA nécessitent un plan avec les fonctions IA activées. Le token API que tu utilises doit avoir la permission update.

Traduire un Text track

Traduis un Text track en envoyant une requête POST à l’endpoint /videos/:id/texttracks/translate.

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

Paramètres

Field	Required	Description
`texttrackId`	Oui	ID du Text track source sur la vidéo.
`targetLanguage`	Oui	Langue cible sous forme de tag BCP-47 (`de`, `fr`, `es`, …).

La langue source et la langue cible doivent toutes deux être prises en charge pour la traduction. Une vidéo ne peut pas avoir deux Text tracks avec la même langue et le même type, tu ne peux donc pas traduire vers une langue qui existe déjà pour ce type.

Réponse

L’objet Text track nouvellement créé.


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