ZEzeno
Podcast Bot

POST /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/autoClips

Changed on

Generate clips (AUTO_CLIP job) for an episode: highlights, chapters or broadcast segments, optionally rendered as video. Uses the given auto-clip config, or the stored one if the body is omitted.

Request

Path parameters

podcastKeystring required
episodeKeystring required

Request body

generate_chaptersboolean

Detect YouTube-style chapter boundaries via LLM and upload chapters.json

clip_generationstring

Clip generation mode. "highlights" = top viral/engaging moments; "chapters" = one clip per chapter boundary; "segments" = named broadcast blocks (Weather, Sports, Traffic, etc.); "none" = skip clip generation, produce chapters only. Every mode but "none" produces an audio clip, a transcript and, when video is set, a video per clip. Fallback value for groups that omit it.

max_clipsinteger

Max number of clips to produce. Used as the count of the single group a config without clip_groups is run as; ignored when clip_groups is set.

min_clip_durationnumber double

Minimum clip length in seconds. Clips shorter than this are padded to center. Applies to highlights mode only. Fallback for groups that omit it.

max_clip_durationnumber double

Maximum clip length in seconds. Clips longer than this are trimmed from the end. Fallback for groups that omit it.

padding_secondsnumber double

Extra seconds added before/after each clip

segment_typesstring[]

List of broadcast segment names to look for (segments mode only). If empty, LLM infers from content. Fallback value for groups.

Response

OK

jobIdstring
statusstring
errorstring

Changes