replace_section
COSTS CREDITS (see list_song_tools): state the price and get the user's confirmation first. Re-generate one section of a song with new lyrics, keeping the rest. Only for Rao/Suno songs and uploaded songs. The section must be 10-60 seconds and at most half the song. Returns an id; poll get_generation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"start": "<start>",
"end": "<end>",
"lyrics": "<lyrics>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "replace_section"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Source song id (songs[].id from get_generation / list_songs / save_upload). | |
| end | Yes | Section end in seconds. | |
| start | Yes | Section start in seconds (get_timed_lyrics helps find it). | |
| style | No | ||
| title | No | ||
| lyrics | Yes | Replacement lyrics for that section. | |
| version | No | Rao/Suno version id (list_song_tools.recreate.versions); omit for the default. Sets the price. | |
| idempotencyKey | Yes | 8-64 chars [A-Za-z0-9._:-]. Same rules as generate_music: stable per logical request, resend the same key + params after a timeout instead of paying twice; new key when anything changes. |