bookoly icon

bookoly

Interact with the bookoly API
Join our community

Actions25

Overview

The node provides video processing capabilities by interacting with an external video API service. Specifically, the "Clip a Video" operation allows users to extract a segment from a video file by specifying start and end times. This is useful for creating highlights, previews, or trimming unwanted parts from videos.

Common scenarios include:

  • Creating short clips from longer videos for social media sharing.
  • Extracting key moments from recorded webinars or tutorials.
  • Preparing video snippets for marketing or presentations.

For example, a user can input a public URL of a full-length video, specify a start time of 30 seconds and an end time of 90 seconds, and receive a clipped video containing only that 60-second segment.

Properties

Name Meaning
Name The name to assign to the resulting video clip.
Video URL The publicly accessible and downloadable URL of the source video file to be clipped.
Mute Video Whether to mute the audio track of the original video in the output clip (true/false).
Clip - Start Time The start time in seconds from the beginning of the video where clipping should begin (minimum 0).
Clip - End Time The end time in seconds from the beginning of the video where clipping should stop. If empty, uses the video's end.
Wait for Completion If true, the node waits until the video clipping process finishes and returns the full video object; if 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 processed video clip. When waiting for completion, this includes detailed information about the generated video such as its URL, metadata, and status. If not waiting, the output contains minimal information like the video ID and creation timestamp.

If the node supports binary data output (not explicitly shown here), it would typically represent the actual video file content or a downloadable stream.

Dependencies

  • Requires an active connection to the external video processing API service at https://bookoly.com/api/v1.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The video source must be accessible via a public URL for the API to download and process it.
  • Optionally, a webhook endpoint can be provided to receive asynchronous notifications.

Troubleshooting

  • Common issues:

    • Invalid or inaccessible video URL: Ensure the URL is publicly reachable and points directly to a downloadable video file.
    • Incorrect start/end times: Start time must be ≥ 0, and end time must be greater than start time and within the video duration.
    • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
    • Network or timeout errors when waiting for completion: Consider disabling wait or increasing workflow timeouts.

  • Error messages:

    • "No handler found for video.clipVideo": Indicates the node configuration does not match any implemented operation; verify resource and operation selections.
    • "Failed to execute clipVideo: <error message>": General failure during execution; check error details for causes such as invalid parameters or API failures.

Links and References

Discussion