Tłumaczenie text track

Tłumaczenie używa AI do utworzenia nowego text track w innym języku na podstawie istniejącego text track. Język źródłowy jest brany ze źródłowego text track, więc wystarczy podać język docelowy. Nowy text track zachowuje ten sam typ (subtitles lub captions) co źródło.

Funkcje AI wymagają planu z włączonymi funkcjami AI. Klucz API, którego używasz, musi mieć uprawnienie videos.update.

Tłumaczenie text track

Przetłumacz text track, wysyłając żądanie POST na 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);

Parametry

Field	Required	Description
`texttrackId`	Tak	ID źródłowego text track na wideo.
`targetLanguage`	Tak	Język docelowy jako tag BCP-47 (`de`, `fr`, `es`, …).

Zarówno język źródłowy, jak i docelowy muszą być obsługiwane przy tłumaczeniu. Wideo nie może mieć dwóch text tracków o tym samym języku i typie, więc nie możesz tłumaczyć na język, który już istnieje dla tego typu.

Odpowiedź

Nowo utworzony obiekt text track.


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