bookoly icon

bookoly

Interact with the bookoly API
Join our community

Actions25

Overview

This node integrates with the Bookoly API to split a video into multiple scenes or segments. It supports three splitting modes:

  • Auto (Scene Detection): Automatically detects scene changes based on visual differences, splitting the video accordingly.
  • Time (Fixed Interval): Splits the video into equal-length segments based on a fixed time duration.
  • Count (Number of Segments): Divides the video into a specified number of equal-length segments.

This node is useful for video editors, content creators, and automation workflows that require breaking down long videos into manageable parts for further processing, analysis, or distribution. For example, it can be used to automatically segment a recorded lecture into chapters or to prepare clips from a longer video for social media sharing.

Properties

Name Meaning
Name The name you want to assign to the video being processed.
Video URL A publicly accessible and downloadable URL pointing to the video file to be split.
Mute Video Whether to mute the original audio track in the video during processing (true or false).
Split - Mode Method to split the video:
• Auto (Scene Detection)
• Time (Fixed Interval)
• Count (Number of Segments)
Split - Segment Length When using "Time" mode, specifies the length (in seconds) of each segment. Must be an integer ≥ 1.
Split - Number of Segments When using "Count" mode, specifies how many equal-length segments to split the video into. Must be an integer ≥ 1.
Split - Min Scene Duration (Sec) When using "Auto" mode, sets the minimum duration (in seconds) allowed for each detected scene. Must be ≥ 0.1 seconds.
Split - Max Scene Duration (Sec) When using "Auto" mode, sets the maximum duration (in seconds) allowed for each detected scene. Must be ≥ 0.1 seconds.
Split - Scene Change Threshold When using "Auto" mode, controls sensitivity for detecting scene changes. Lower values detect more changes; higher values detect fewer. Range: 0.1 to 1.
Wait for Completion If enabled (true), the node waits until the video splitting process completes and returns the full video object. If disabled (false), it returns only the ID and creation timestamp immediately.
Webhook URL Optional URL to receive webhook notifications about the video processing status, including video ID and URL.

Output

The node outputs JSON data representing the result of the video splitting operation. Depending on the "Wait for Completion" setting, this output may include:

  • The full video object with detailed information about the split scenes and their metadata once processing is complete.
  • Or just the video ID and creation timestamp if the node does not wait for completion.

If the video contains binary data (e.g., video files or thumbnails), it would typically be referenced by URLs or IDs rather than included directly in the output JSON.

Dependencies

  • Requires access to the Bookoly API service at https://bookoly.com/api/v1.
  • An API key credential must be configured in n8n to authenticate requests to the Bookoly API.
  • The video file must be accessible via a public URL for the API to download and process it.
  • Optional webhook URL can be provided to receive asynchronous notifications about processing status.

Troubleshooting

  • Common Issues:

    • Invalid or inaccessible video URL: Ensure the video URL is publicly accessible and downloadable.
    • Incorrect API credentials: Verify that the API key credential is correctly set up and has necessary permissions.
    • Timeout or long processing times: Large videos or complex scene detection may take time; consider enabling webhook notifications or increasing workflow timeouts.
    • Invalid parameter combinations: For example, specifying segment length when using "Count" mode or vice versa.

  • Error Messages:

    • "No handler found for video.splitVideoIntoScenes": Indicates a misconfiguration or missing implementation for the selected resource-operation pair.
    • "Failed to execute splitVideoIntoScenes: <error message>": General failure during execution; check the error message for details such as network issues or invalid parameters.

  • Resolutions:

    • Double-check all input properties for correctness.
    • Confirm network connectivity and API key validity.
    • Use webhook notifications to monitor asynchronous processing.
    • Review API documentation for valid parameter ranges and constraints.

Links and References

Discussion