Traducir una pista de texto

La traducción usa IA para crear una nueva pista de texto en otro idioma a partir de una pista de texto existente. El idioma de origen se toma de la pista de texto de origen, así que solo necesitas indicar el idioma de destino. La nueva pista de texto mantiene el mismo tipo (subtitles o captions) que la 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 una pista de texto

Traduce una pista de texto 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 de la pista de texto 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 pistas de texto con el mismo idioma y tipo, por lo que no puedes traducir a un idioma que ya exista para ese tipo.

Respuesta

El objeto de la pista de texto recién creada.


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