Traducir un Text track

La traducción usa IA para crear un nuevo Text track 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 nuevo Text track mantiene el mismo tipo (subtitles o captions) que el de origen.

Las funciones de IA requieren un plan con las funciones de IA habilitadas. El token de API que uses debe tener el permiso 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

Field	Required	Description
`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 estar soportados para la traducción. Un vídeo no puede tener dos Text tracks con el mismo idioma y tipo, por lo que no puedes traducir a un idioma que ya exista para ese tipo.

Respuesta

El objeto Text track recién creado.


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