Media Chapters
Media Chapters
hold certain structures of a Media
asset based on entries which can be linked to Media Sections
.
Every Media
asset of type video or audio has an AI generated Media
chapter of type autogenerated
- this autogenerated
Media
chapter is not editable.
In order to change an autogenerated
Media
chapter, you have to copy it.
The copy has type usergenerated
and is editable.
ποΈ Create a media chapter
A `Media Chapter` structures a `Media` asset based on `entries` which can be linked with `Sections`.
ποΈ List media chapters
List all `Media Chapters` of the `Media` asset.
ποΈ Retrieve a media chapter
Retrieving a `Media Chapter` by id will load a certain structure of a `Media` asset.
ποΈ Delete a media chapter
Deletes a `Media Chapter` of a `Media` asset by id. All referenced `entries` and `Sections` will be also deleted.
ποΈ Update a media chapter
Update a `Media Chapter` name or description.
ποΈ Copy a media chapter
Copy a `Media Chapter` will duplicate and all referenced `entries` and `Sections`.
ποΈ Recalculate autogenerated media chapters
Existing structure of the autogenerated `Media Chapter` will be recreated based on the the `videoText` (OCR) and `transcript` [Metadata](#tag/Media-Metadata). Existing segment embeddings will be deleted and recalculated.
ποΈ Create an entry
`Entries` are used to structure a `Media` asset and belong to a dedicated `Media Chapter`.
ποΈ Bulk update entries
The endpoint can be used to update multiple `Entries` in `Media Chapter` with one request.
ποΈ Update an entry
Update an entry of a `Media Chapter` can be used to change the title of the `entry`.
ποΈ Delete an entry
It will delete also all child `entries` of the `Media Chapter`.
ποΈ Link a section with an entry
This endpoint can be used to structure your `Media` asset. The `Section` to be linked should be created in the context of the `Media Chapter`.
ποΈ Unlink a section from an entry
Removing a `Section` from an entry will make that entry a navigational element of the `Media Chapter`.