Choose the source passage
Identify the completed track and listen to the section you want to revise. Retain its task/audio identifiers and original recording for a before-and-after review.
Replace Section music editing API
Select a completed generated track and identify the passage you want to revise. Replace Section uses the source task_id and audio_id, the replacement prompt, tags and title, and infill_start_s/infill_end_s to define the time range. Prepare the surrounding song context, listen to the returned result with the original and review the edited passage and its transitions before choosing the next version.
Vidgo provides access to Replace Section through PoYo’s music-tool integration. Model and tool names and trademarks belong to their respective owners.Explore the Replace Section Task
Listen to the source and choose the passage to revise. Prepare the start and end times, replacement direction and complete song context, then inspect the returned music around the edited section.
Replace Section Source Tracks, Time Ranges and Lyric Inputs
Provide task_id and audio_id from the completed source, plus prompt, tags, title, infill_start_s and infill_end_s. Use seconds for the time range: start at zero or later, keep the end greater than the start and within the original duration, and use the documented two-decimal precision when preparing timing. The current online form also requires full_lyrics; the direct API treats it as optional context for the complete song.
| Model / task | Input and workflow |
|---|---|
| Replace Section | Replace specific sections of generated music tracks with precision timing control. Modify choruses, verses, or any segment by specifying start and end times. Maintains overall coherence while allowing targeted changes to lyrics, style, or musical elements. |
Replace Section: Targeted Section Replacement and Lyric Context Controls
Use the input required by this operation and inspect the returned result together with its source. The guidance below explains how to prepare the request, review the output and retain the information needed for the next creative or development step.
{
"model": "replace-section",
"input": {
"task_id": "WC08A0TNOI23JRRE",
"audio_id": "483b67b8-0433-4000-adde-079b765859a6",
"prompt": "[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery path begins right here\nOne small step and skies are clear",
"tags": "Warm indie folk, acoustic guitar, light hand percussion, clear lead vocal",
"title": "Windows After Rain Revised 1",
"infill_start_s": 20,
"infill_end_s": 40,
"full_lyrics": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery path begins right here\nOne small step and skies are clear"
}
}Set the start and end times
Prepare infill_start_s and infill_end_s in seconds within the source duration. Review the selected window and its boundaries before submitting the replacement.
Describe the replacement section
Use prompt for the new lyrics or musical content, tags for the style and title for the result. Keep the written direction with the time window when reviewing the edited passage.
{
"model": "replace-section",
"input": {
"task_id": "WC08A0TNOI23JRRE",
"audio_id": "9fc21b20-0c58-4d17-8d26-5a58a161ccbf",
"prompt": "[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery path begins right here\nOne small step and skies are clear",
"tags": "Warm indie folk, acoustic guitar, light hand percussion, clear lead vocal",
"title": "Windows After Rain Revised 2",
"infill_start_s": 20,
"infill_end_s": 40,
"full_lyrics": "[Verse]\nRain has left the window bright\nMorning folds away the night\nOn the table, bread and tea\nThere is room for you and me\n[Chorus]\nOpen up the day again\nLet the sunlight wander in\nEvery path begins right here\nOne small step and skies are clear"
}
}Prepare the complete song context
Use full_lyrics for the complete updated song text; it is required by the current online form and optional in the direct API. Retain that context when checking how the section fits the full song.
Review the edit and transitions
Listen to the complete returned result around the target passage and compare it with the source. Save the selected candidate and actual timing/input fields for the next revision.
Replace Section Song Chorus Replacement and Transition Examples
Both vocal candidates were revised over the 20–40-second window, with replacement chorus text and the complete updated lyrics supplied as context. Compare each original with its returned candidates, listening through the requested interval and both transitions while checking the changed lyric line.
Musical direction
[Chorus] Open up the day again Let the sunlight wander in Every path begins right here One small step and skies are clear
Musical direction
[Chorus] Open up the day again Let the sunlight wander in Every path begins right here One small step and skies are clear
Music Workflow Uses for Replace Section
Use the completed candidate you want to revise and retain its original audio URL. Listen to the intended passage and identify its time boundaries before writing the replacement brief. Prepare the complete updated song lyrics when using the online form or when that context is useful to the API request.
Revising a verse
Select the verse in the completed source and prepare the new text or musical direction. Review the returned passage and its transitions in the context of the song.
Developing a chorus variation
Define the chorus time window and describe the replacement with tags and song context. Listen to the result before choosing the next version of the chorus.
Changing a musical passage
Identify the source range and prepare the intended musical treatment. Compare the completed edit with the original passage and adjacent sections.
Refining lyrics within a time range
Prepare the selected passage, replacement words and complete lyric context. Review the generated phrasing and its relationship to the surrounding song.
A focused editing review
Retain the source, exact window and replacement brief with the result. Use those materials when discussing the edited content and transition quality.
Organizing successive section revisions
Keep each selected edit with its source identifiers, time range and actual input. Compare the versions before deciding which passage to use in the project.
Replace Section Input Requirements and API Pricing
The price table reads the current catalog rate for a new processing request in this task. Preparing source music or submitting another music operation uses that operation’s own price. Review the current rate before submitting, retain the returned processing task ID and use the completed result when planning the next step.
| Tool | Provider | Operation | Input | Result type | Current rate |
|---|---|---|---|---|---|
| Replace Section | PoYo | Timed section editing | Source IDs, replacement prompt/tags/title and infill times | Music result with a revised section | $0.05 / request |
How to Use Replace Section on Vidgo
Prepare the source input, then review the completed result and its next use.
Test online
Test the prepared request online
Open the task with the completed source task and audio IDs. Fill the replacement prompt, tags, title, start/end times and the full_lyrics required by the current form. Check that the time window matches the source, review the current price and submit, then listen to the completed passage and surrounding transitions.
Why Use Replace Section on Vidgo
Use the existing task, current request rate and API documentation to connect source preparation, result review and the next music workflow.
Source preparation and result review
Prepare the input required by the operation
Use the completed candidate you want to revise and retain its original audio URL. Listen to the intended passage and identify its time boundaries before writing the replacement brief. Prepare the complete updated song lyrics when using the online form or when that context is useful to the API request.
Inspect the completed output
Listen to the edited range and the transitions before and after it. Compare the replacement lyrics or musical treatment with the prompt and tags, then review the surrounding song with the original source. Keep the time window, full-song context and selected result together when preparing another revision.
Review the current request rate
The price table reads the current catalog rate for a new processing request in this task. Preparing source music or submitting another music operation uses that operation’s own price. Review the current rate before submitting, retain the returned processing task ID and use the completed result when planning the next step.
API integration and follow-up work
Use the accepted request fields
Submit model: replace-section with the source IDs, prompt, tags, title and infill_start_s/infill_end_s. Add full_lyrics when supplying complete-song context and negative_tags when describing elements to reduce. Save the processing task_id and query music details for the edited audio result.
Track the processing task
Authenticate with your Vidgo API credentials and submit the exact model identifier with the required input fields. Retain the returned processing task_id so your application can track the operation and retrieve its result. Use the task documentation when configuring any completion notification.
Retain the result and source association
Query /api/generate/detail/music?task_id=YOUR_PROCESSING_TASK_ID with the returned processing ID, or handle the configured notification. When the task finishes, inspect the operation-specific result in files and retain its source association. Listen to the edited range and the transitions before and after it. Compare the replacement lyrics or musical treatment with the prompt and tags, then review the surrounding song with the original source. Keep the time window, full-song context and selected result together when preparing another revision.
Replace Section API FAQ
Select a completed generated track and identify the passage you want to revise. Replace Section uses the source task_id and audio_id, the replacement prompt, tags and title, and infill_start_s/infill_end_s to define the time range. Prepare the surrounding song context, listen to the returned result with the original and review the edited passage and its transitions before choosing the next version.
Explore More Model Families
Recommended Reading
Read music-tool introductions, API guides and platform comparisons to understand required sources, returned results, request costs and follow-up workflows.
