Traduzir uma faixa de texto

A tradução usa IA para criar uma nova faixa de texto noutro idioma a partir de uma faixa de texto existente. O idioma de origem é obtido a partir da faixa de texto de origem, por isso só precisas de indicar o idioma de destino. A nova faixa de texto mantém o mesmo tipo (subtitles ou captions) que a de origem.

As funções de IA exigem um plano com funções de IA ativadas. O token de API que usas tem de ter a permissão update.

Traduzir uma faixa de texto

Traduz uma faixa de texto enviando um pedido POST para o 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	Obrigatório	Descrição
`texttrackId`	Sim	ID da faixa de texto de origem no vídeo.
`targetLanguage`	Sim	Idioma de destino como tag BCP-47 (`de`, `fr`, `es`, …).

Tanto o idioma de origem como o de destino têm de ser suportados para tradução. Um vídeo não pode ter duas faixas de texto com o mesmo idioma e tipo, por isso não podes traduzir para um idioma que já exista para esse tipo.

Resposta

O objeto da faixa de texto recém-criada.


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