Overview
This node integrates with the Cleanvoice AI service to create an edit task for audio or video files. It uploads a media file URL along with a selected processing template to Cleanvoice, which then performs audio or video editing based on the chosen template. This is useful for automating content cleanup such as removing filler words, silences, or enhancing audio/video quality.
Common scenarios include:
- Automatically cleaning up podcast episodes by removing ums, ahs, and long pauses.
- Enhancing video recordings by applying noise reduction or other audio improvements.
- Batch processing multiple media files through predefined templates.
Example: Upload a podcast episode URL as an audio file, select a "Podcast Cleanup" template, and trigger Cleanvoice to process and return the edited result metadata.
Properties
| Name | Meaning |
|---|---|
| File URL | URL of the audio or video file to be processed. |
| Upload Type | Type of content to upload; options are: Audio (single track) or Video. |
| Template Name or ID | The processing template to apply; choose from a dynamically loaded list filtered by upload type. |
Output
The node outputs JSON data representing the response from the Cleanvoice API after creating the edit task. This typically includes metadata about the created edit job such as its ID, status, and related information.
No binary data is output by this node.
Dependencies
- Requires an API key credential for Cleanvoice AI to authenticate requests.
- Makes HTTP requests to Cleanvoice's API endpoints (
https://api.cleanvoice.ai/v2/editsandhttps://api.cleanvoice.ai/v2/configurations). - The node dynamically loads available templates from Cleanvoice based on the selected upload type.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication errors.
- Providing an invalid file URL or inaccessible media file may cause the API to reject the request.
- Selecting a template incompatible with the upload type could lead to errors or unexpected results.
Error messages:
- Errors returned from the Cleanvoice API will be included in the node output if "Continue On Fail" is enabled.
- Typical error messages might relate to authorization failures, invalid parameters, or network issues.
Resolutions:
- Ensure the API key is correctly configured and has necessary permissions.
- Verify that the file URL is publicly accessible and points to a supported media format.
- Select the correct template matching the upload type (audio or video).
Links and References
- Cleanvoice AI Documentation
- n8n Expressions Documentation (for using expressions in template selection)