bookoly icon

bookoly

Interact with the bookoly API

Overview

The node integrates with the Bookoly API to perform various video processing operations. Specifically, for the Mute a Video operation under the Video resource, it allows users to mute the audio track of a given video file by providing its public URL. This is useful in scenarios where you want to remove sound from videos before sharing or further processing them, such as creating silent promotional clips, preparing videos for environments where sound is disruptive, or complying with copyright restrictions on audio.

Practical examples:

  • Muting background noise in a recorded video before uploading it to social media.
  • Preparing a video for use in a presentation where audio is not needed.
  • Creating silent video loops for display in public areas.

Properties

Name Meaning
Name The name to assign to the processed video.
Video URL The publicly accessible and downloadable URL of the video file to be muted.
Wait for Completion If enabled (true), the node waits until the muting process completes and returns the full video object. If disabled (false), it returns only the video 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. When waiting for completion, this includes detailed information about the muted video such as its ID, URL, metadata, and timestamps. If not waiting, the output contains minimal information like the video ID and creation time.

If the node supports binary data output (not explicitly shown here), it would typically represent the muted video file itself or related media content.

Dependencies

  • Requires an active connection to the Bookoly API service.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • Internet access to download the source video from the provided URL and to communicate with the Bookoly API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or inaccessible video URL: Ensure the URL is publicly accessible and points directly to a downloadable video file.
    • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
    • Network connectivity problems: Confirm that n8n can reach both the video URL and the Bookoly API servers.
    • Timeout or long processing times: If "Wait for Completion" is enabled, large videos may take longer; consider disabling wait or using webhook notifications.
  • Error messages:

    • No handler found for video.muteVideo: Indicates the operation is not implemented or incorrectly referenced; check spelling and supported operations.
    • Failed to execute muteVideo: <error message>: Generic failure during execution; review the error details for causes such as invalid input or API errors.

Links and References

Discussion