Gerar capítulos

A geração de capítulos usa IA para dividir um vídeo em capítulos a partir de uma faixa de texto existente. Cada capítulo tem um título e um timestamp. O primeiro capítulo começa sempre em 00:00:00. Os capítulos gerados são guardados no objeto do vídeo.

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.

Gerar capítulos

Gera capítulos enviando um pedido POST para o endpoint /videos/:id/chapters/generate.

CURL


curl -X POST https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/chapters/generate \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"texttrackId": "[TEXTTRACK_ID]", "numberOfChapters": 6}'

JavaScript / Node.js


const data = {
texttrackId: "[TEXTTRACK_ID]",
numberOfChapters: 6 // optional, 2-100; derived from duration if omitted
};
 
const response = await fetch('https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/chapters/generate', {
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]",
"numberOfChapters" => 6 // optional, 2-100; derived from duration if omitted
];
 
$response = $client->request('POST', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/chapters/generate', [
'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.
`numberOfChapters`	Não	Número de capítulos a gerar, entre 2 e 100. Derivado da duração se for omitido.

Resposta

Os capítulos gerados, que são também guardados no objeto do vídeo.


{
  "chapters": [
    { "title": string, "timestamp": "00:00:00" }
  ],
  "message": "Chapters successfully generated and saved"
}