Regenerate a section, extend or make a similar track
derive_musicMakes a NEW version of a track from an existing version (spends credits: refused until the user approved the cost, see approve_spending). origin=repaint regenerates only the section [start, end] seconds (at least 3 s) and keeps the rest; origin=extend adds seconds of new music after the end, in the same mood (the final length must fit the user's plan); origin=cover makes a similar track from this one (closeness: close, medium or loose). note says what should change and is added to the end of the source prompt as written, so write it in English tags. Lyrics, tempo and key come from the source version. Charges the generated seconds (the section, the tail; cover charges the whole track) at the version's quality level. Same response as generate_music.
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": {
"version_id": "<version_id>",
"origin": "<origin>"
},
"name": "derive_music"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | repaint: end of the section, in seconds (at least 3 s after start). | |
| note | No | What should change, added to the source prompt as is (English tags). | |
| wait | No | false = only queues it and returns the jobId for job_status (see generate_music). | |
| start | No | repaint: start of the section, in seconds. | |
| origin | Yes | ||
| quality | No | Quality level; omitted: the track's current level. | |
| seconds | No | extend: how many seconds to add (3 to 90; more, in steps). The final length must fit the plan: up to 4 min for this account. | |
| closeness | No | cover: how close to the source (default medium). | |
| version_id | Yes | The source version (a generationId of a track from generate_music, get_entity or find_sounds). | |
| auto_choose | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| created | Yes | ||
| credits | Yes | ||
| refunded | Yes | ||
| studioUrl | Yes | ||
| generationIds | Yes |