Tradurre un Text track

La traduzione usa l’IA per creare un nuovo Text track in un’altra lingua a partire da un Text track esistente. La lingua di origine viene presa dal Text track di origine, quindi devi fornire solo la lingua di destinazione. Il nuovo Text track mantiene lo stesso tipo (subtitles o captions) dell’originale.

Le funzioni IA richiedono un piano con le funzioni IA abilitate. Il token API che usi deve avere il permesso update.

Tradurre un Text track

Traduci un Text track inviando una richiesta POST all’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);

Parametri

Campo	Obbligatorio	Descrizione
`texttrackId`	Sì	ID del Text track di origine sul video.
`targetLanguage`	Sì	Lingua di destinazione come tag BCP-47 (`de`, `fr`, `es`, …).

Sia la lingua di origine sia quella di destinazione devono essere supportate per la traduzione. Un video non può avere due Text tracks con la stessa lingua e lo stesso tipo, quindi non puoi tradurre in una lingua che esiste già per quel tipo.

Risposta

L’oggetto Text track appena creato.


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