bookoly icon

bookoly

Interact with the bookoly API

Video → Split a Video Into Scenes

AI-generated

Summary

Splits a video into scenes using auto-detection, fixed intervals, or a specified segment count.

Inputs

  • name (required) — The name of the video
  • url (required) — The public and downloadable URL of the video file
  • mute — Whether to mute the original video audio
  • type (required) — Choose how to split the video into scenes
  • amount (required) — Splits the video into equal segments; when mode is time, specifies duration in seconds per segment; when mode is count, specifies total number of equal-length segments
  • min_duration (required) — The minimum length of each automatically detected scene. Required when mode is auto.
  • max_duration (required) — The maximum length of each automatically detected scene. Required when mode is auto.
  • scene_change_threshold (required) — Lower values detect more scene changes; higher values detect fewer. Range: 0.1 – 1. Required when mode is auto.
  • wait — If enabled, the node pauses the workflow and checks the server until the video generation is finished, then returns the full video object. If disabled, only the ID and creation timestamp are returned.
  • webhook_url — Enter a valid URL to receive webhook notifications. Video ID and URL will be included.

Output shape

Based on wait parameter: when true, returns full video object with scene timestamps and metadata; when false, returns only the video ID and creation timestamp.

Mode-specific parameters (min_duration, max_duration, scene_change_threshold) are only active when type is set to auto.

Discussion