Actions25
- Sound Actions
- Speech Actions
- File Actions
- Transcription Actions
- Video Actions
- Add Audio to a Video
- Add Audio with Subtitles to a Video
- Add Subtitles to a Video
- Add Subtitles to a Video From a File
- Add Watermark to a Video
- Blur a Video
- Clip a Video
- Create a Slideshow
- Crop a Video
- Extract Audio From a Video
- Frame a Video
- Generate a Video
- Get a Specific Video
- Mute a Video
- Rotate a Video
- Split a Video Into Scenes
Overview
The node integrates with the Bookoly API to combine multiple audio files into a single sound. It is useful in scenarios where users want to merge several audio clips, such as creating a podcast episode from segments, combining sound effects for multimedia projects, or assembling music tracks.
When executed, the node takes a list of publicly accessible audio URLs and sends them to the Bookoly service, which processes and combines these sounds into one. The node can either wait for the combination process to complete and return the full sound object or return immediately with just the sound ID and creation timestamp, depending on user preference.
Properties
| Name | Meaning |
|---|---|
| Name | The name assigned to the resulting combined sound. |
| Audio | A collection of public and downloadable audio file URLs to be combined. Multiple URLs can be added and sorted. |
| Wait for Completion | Boolean option to either pause the workflow until the sound is fully generated (true) or return immediately with minimal info (false). |
| Webhook URL | Optional URL to receive webhook notifications about the sound generation status, including sound ID and URL. |
Output
The node outputs JSON data representing the combined sound object returned by the Bookoly API. If "Wait for Completion" is enabled, this includes detailed information about the combined sound such as its ID, creation timestamp, and possibly the URL to access the combined audio.
If "Wait for Completion" is disabled, the output JSON contains only the sound ID and creation timestamp, indicating that the combination process has started but is not yet finished.
The node does not output binary data directly; it works with URLs referencing audio files.
Dependencies
- Requires an active connection to the Bookoly API.
- Needs an API key credential configured in n8n for authentication with the Bookoly service.
- Internet access to reach the Bookoly API endpoints and to access the provided public audio URLs.
- Optionally, a valid webhook URL if webhook notifications are desired.
Troubleshooting
Common Issues:
- Invalid or inaccessible audio URLs: Ensure all audio URLs are publicly accessible and downloadable.
- API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
- Network connectivity problems: Confirm that the n8n instance can reach the Bookoly API and the audio URLs.
- Webhook URL misconfiguration: If using webhooks, ensure the URL is valid and reachable.
Error Messages:
No handler found for sound.combineSounds: Indicates the operation or resource name might be incorrect or missing.Failed to execute combineSounds: <message>: General failure during execution, often due to API errors or invalid inputs.
To resolve errors, check input parameters, credentials, and network connectivity. Review the Bookoly API documentation for specific error codes and messages.
Links and References
- Bookoly Official Website
- Bookoly API Documentation (assumed based on base URL)
- n8n Documentation on Creating Custom Nodes