Overview
This node acts as a trigger that watches for completed edits processed by the Cleanvoice AI service. It periodically polls the Cleanvoice API to detect when audio or video content editing tasks have been completed based on a selected template. When new completed tasks are found, it outputs their details.
Common scenarios where this node is beneficial include automating workflows that depend on the completion of audio or video editing jobs, such as post-processing, publishing, or notifying users once Cleanvoice AI finishes its work.
For example, you could use this node to:
- Automatically start transcription or further processing after an audio track has been cleaned.
- Trigger notifications or downstream workflows when a video edit is finalized using a specific Cleanvoice template.
Properties
| Name | Meaning |
|---|---|
| Upload Type | Type of content to watch for completions. Options: "Audio" (single track), "Video" (video). |
| Template Name or ID | Select a Cleanvoice AI template from a dynamically loaded list filtered by the chosen upload type, or specify a template ID via expression. |
Output
The node outputs an array of JSON objects representing completed Cleanvoice AI editing tasks matching the selected template. Each object contains metadata about a completed task, including at least:
id: The unique identifier of the completed task.created_at: Timestamp string indicating when the task was completed.
The output only includes tasks that are new since the last poll and filters out older tasks beyond a 7-day window. This ensures only recent completions trigger downstream workflow actions.
No binary data is output by this node.
Dependencies
- Requires an API key credential for Cleanvoice AI to authenticate requests.
- Makes HTTP GET requests to Cleanvoice AI endpoints:
- To fetch available templates/configurations filtered by upload type.
- To retrieve recently completed tasks for the selected template.
- Needs internet access to communicate with the Cleanvoice AI API.
Troubleshooting
- No triggers firing: Ensure the API key credential is valid and has permissions. Verify that there are actually completed tasks for the selected template in Cleanvoice AI.
- Empty output arrays: Could mean no new completed tasks since the last poll or no tasks within the last 7 days. Check if the template ID and upload type are correct.
- API request failures: May result from invalid credentials, network issues, or Cleanvoice API downtime. Confirm API key validity and network connectivity.
- Template loading issues: If the template dropdown does not populate, verify the API key and that the Cleanvoice API endpoint is reachable.
Links and References
- Cleanvoice AI API Documentation (for more details on templates and completed tasks)
- n8n Expressions Documentation (for specifying template IDs dynamically)