Traduire une piste de texte

La traduction utilise l’IA pour créer une nouvelle piste de texte dans une autre langue à partir d’une piste de texte existante. La langue source est reprise de la piste de texte source, tu n’as donc qu’à fournir la langue cible. La nouvelle piste de texte 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 une piste de texte

Traduis une piste de texte 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 de la piste de texte 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 pistes de texte 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 piste de texte nouvellement créé.


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