Tłumaczenie ścieżki tekstowej

Tłumaczenie używa AI do utworzenia nowej ścieżki tekstowej w innym języku na podstawie istniejącej ścieżki tekstowej. Język źródłowy jest pobierany ze źródłowej ścieżki tekstowej, więc musisz podać tylko język docelowy. Nowa ścieżka tekstowa zachowuje ten sam typ (subtitles lub captions) co źródło.

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

Tłumaczenie ścieżki tekstowej

Przetłumacz ścieżkę tekstową, 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łowej ścieżki tekstowej 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 w tłumaczeniu. Wideo nie może mieć dwóch ścieżek tekstowych 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 ścieżki tekstowej.


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