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 del vídeo.

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

Campo	Obligatorio	Descripción
`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 del vídeo.


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