Actions16
Replace Music Section
AI-generatedSummary
Replace a specified time section within an existing generated music track using a text prompt to describe the new section.
Inputs
- Task ID (required) — Task ID of the source music to modify.
- Prompt — Text description of the music to generate for replacement in the specified section.
- Section Start (Seconds) — Start time in seconds of the section to replace (default 0).
- Section End (Seconds) — End time in seconds of the section to replace (default 10).
- Negative Tags — Music styles to exclude from the generated replacement section (e.g. "drums, electric guitar").
- Reply URL — Optional webhook URL to call when the replacement task completes.
- Reply Ref — Custom reference string included in webhook callbacks.
- Wait for Completion — Boolean flag to wait until the replacement task completes, polling every 3 seconds with a 5-minute timeout (default true).
Output shape
a JSON object containing task status, result URLs, and metadata about the replaced music section
If 'Wait for Completion' is true, the node polls the API until the task finishes and returns the final result. Otherwise, it returns the initial API response containing the task ID. The result JSON may include URLs to the new audio segment.
Examples
Example 1: Replace a 10-second segment starting at 30 seconds in a generated music track with new music described as "soft piano melody with ambient background".
Provide the Task ID of the original music, set Prompt to "soft piano melody with ambient background", Section Start to 30, Section End to 40, and optionally set Wait for Completion to true to wait for processing.