bookoly icon

bookoly

Interact with the bookoly API

Overview

This node integrates with the Bookoly API to perform various video-related operations. Specifically, for the "Extract Audio From a Video" operation under the "Video" resource, it extracts the audio track from a given video file URL. This is useful when you want to isolate audio content from videos for purposes such as transcription, podcast creation, or audio analysis.

Common scenarios include:

  • Extracting background music or dialogue from a video.
  • Preparing audio-only content from video lectures or presentations.
  • Creating audio samples from video clips for further processing.

Properties

Name Meaning
Name The name to assign to the video being processed.
Video URL The publicly accessible and downloadable URL of the video file from which audio will be extracted.
Wait for Completion If enabled, the node waits until the audio extraction process completes and returns the full video object; if disabled, it returns only the ID and creation timestamp immediately.
Webhook URL Optional URL to receive webhook notifications about the process status, including video ID and URL.

Output

The node outputs JSON data representing the result of the audio extraction operation. When waiting for completion, this includes the full video object with details such as the extracted audio information. If not waiting, the output contains minimal metadata like the video ID and creation timestamp.

If the node supports binary data output (not explicitly shown here), it would typically represent the extracted audio file in binary form.

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.
  • Optional: A valid webhook URL endpoint if webhook notifications are desired.

Troubleshooting

  • Common Issues:

    • Invalid or inaccessible video URL: Ensure the video URL is publicly accessible and downloadable.
    • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
    • Timeout or long processing times: Use the "Wait for Completion" property appropriately; if disabled, check webhook notifications for completion status.
  • Error Messages:

    • No handler found for video.extractAudioFromVideo: Indicates the operation is not implemented or incorrectly referenced.
    • Failed to execute extractAudioFromVideo: <error message>: General failure during execution; check the error message for specifics such as network issues or invalid input.

Links and References

Discussion