Générer des chapitres

La génération de chapitres utilise l’IA pour découper une vidéo en chapitres à partir d’un Text track existant. Chaque chapitre a un titre et un timestamp. Le premier chapitre commence toujours à 00:00:00. Les chapitres générés sont enregistrés sur l’objet vidéo.

Les fonctions IA nécessitent un plan avec les fonctions IA activées. Le token API que tu utilises doit avoir la permission update.

Générer des chapitres

Génère des chapitres en envoyant une requête POST à l’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);

Paramètres

Field	Required	Description
`texttrackId`	Oui	ID du Text track source sur la vidéo.
`numberOfChapters`	Non	Nombre de chapitres à générer, entre 2 et 100. Dérivé de la durée si omis.

Réponse

Les chapitres générés, qui sont aussi enregistrés sur l’objet vidéo.


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