Kapitel generieren

Die Kapitelgenerierung nutzt KI, um ein Video anhand einer bestehenden Textspur in Kapitel zu unterteilen. Jedes Kapitel hat einen Titel und einen Timestamp. Das erste Kapitel beginnt immer bei 00:00:00. Die generierten Kapitel werden im Video-Objekt gespeichert.

KI-Funktionen erfordern einen Plan mit aktivierten KI-Funktionen. Der API-Token, den du verwendest, muss die Berechtigung update haben.

Kapitel generieren

Generiere Kapitel, indem du eine POST-Anfrage an den Endpoint /videos/:id/chapters/generate sendest.

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);

Parameter

Field	Required	Description
`texttrackId`	Ja	ID der Quell-Textspur des Videos.
`numberOfChapters`	Nein	Anzahl der zu generierenden Kapitel, zwischen 2 und 100. Wird aus der Dauer abgeleitet, wenn nicht angegeben.

Antwort

Die generierten Kapitel, die außerdem im Video-Objekt gespeichert werden.


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