Tradurre una traccia di testo

La traduzione usa l’IA per creare una nuova traccia di testo in un’altra lingua a partire da una traccia di testo esistente. La lingua di origine viene presa dalla traccia di testo di origine, quindi devi fornire solo la lingua di destinazione. La nuova traccia di testo 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 una traccia di testo

Traduci una traccia di testo 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 della traccia di testo 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 tracce di testo con la stessa lingua e lo stesso tipo, quindi non puoi tradurre in una lingua che esiste già per quel tipo.

Risposta

L’oggetto traccia di testo appena creato.


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