Traducir un text track

La traducción usa IA para crear un text track nuevo en otro idioma a partir de un text track existente. El idioma de origen se toma del text track de origen, así que solo necesitas indicar el idioma de destino. El text track nuevo conserva el mismo tipo (subtitles o captions) que el de origen.

Las funciones de IA requieren un plan con las funciones de IA habilitadas. La Clave API que uses debe tener el permiso videos.update.

Traducir un text track

Traduce un text track enviando una solicitud POST al 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);

Parámetros

Campo	Obligatorio	Descripción
`texttrackId`	Sí	ID del text track de origen en el vídeo.
`targetLanguage`	Sí	Idioma de destino como etiqueta BCP-47 (`de`, `fr`, `es`, …).

Tanto el idioma de origen como el de destino deben ser compatibles con la traducción. Un vídeo no puede tener dos text tracks con el mismo idioma y tipo, así que no puedes traducir a un idioma que ya exista para ese tipo.

Respuesta

El objeto del text track recién creado.


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