mashup_songs
COSTS CREDITS (see list_song_tools): state the price and get the user's confirmation first. Blend two of the user's songs into a new one (Rao/Suno). mode "simple": describe the result in description; mode "custom": your lyrics + style + title. 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>",
"secondId": "<secondId>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "mashup_songs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Source song id (songs[].id from get_generation / list_songs / save_upload). | |
| mode | No | simple | |
| style | No | custom mode. | |
| title | No | custom mode. | |
| lyrics | No | custom mode: lyrics. | |
| version | No | Rao/Suno version id (list_song_tools.recreate.versions); omit for the default. Sets the price. | |
| secondId | Yes | The second song id (must also be the user's). | |
| description | No | simple mode: one-line description (required unless instrumental). | |
| vocalGender | No | ||
| instrumental | No | ||
| 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. |