Generar capítulos

La generación de capítulos usa IA para dividir un vídeo en capítulos a partir de un Text track existente. Cada capítulo tiene un título y una marca de tiempo. El primer capítulo siempre empieza en 00:00:00. Los capítulos generados se guardan en el objeto de vídeo.

Las funciones de IA requieren un plan con las funciones de IA habilitadas. El token de API que uses debe tener el permiso update.

Generar capítulos

Genera capítulos enviando una solicitud POST al 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

Field	Required	Description
`texttrackId`	Sí	ID del Text track de origen en el vídeo.
`numberOfChapters`	No	Número de capítulos a generar, entre 2 y 100. Se deriva de la duración si se omite.

Respuesta

Los capítulos generados, que también se guardan en el objeto de vídeo.


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