Generate Mashup Music
POST
/api/v1/generate/mashup
Create remix music using AI models by combining multiple audio tracks.
Usage Guide
uploadUrlList must contain 2 audio URLs. Upstream uses only the first 2.Parameter Details
uploadUrlList, callBackUrl, model, style, titlelyrics is optional and takes priority over prompt as lyrics. If lyrics is omitted, prompt is used as lyrics when provided| Model | lyrics / prompt | style | title |
|---|---|---|---|
| 3000 | 200 | 80 | |
| 5000 | 1000 | 80 | |
| 5000 | 1000 | 80 | |
| 5000 | 1000 | 80 | |
| V6 / V6_WILD / V6_MINI | 5000 | 1000 | 80 |
Developer Notes
text (text generation), first (first track complete), complete (all complete).uploadUrlList must contain 2 audio file URLs. Upstream uses only the first 2.Optional Parameters
| Parameter | Type | Description |
|---|---|---|
lyrics | string | Lyrics for the mashup. Optional. V6 maximum 5000 characters. Takes priority over prompt as lyrics. |
prompt | string | Used as lyrics only when lyrics is not provided. Optional. V6 maximum 5000 characters. |
vocalGender | string | Vocal gender preference. m for male, f for female. In practice, this parameter only increases the probability but does not guarantee adherence to the specified vocal gender. |
styleWeight | number | Strength of adherence to style. Range is 0–1, with two decimal places. Example: 0.61. |
weirdnessConstraint | number | Creativity/discreteness level. Range is 0–1, with two decimal places. Example: 0.72. |
audioWeight | number | Weight of audio elements. Range is 0–1, with two decimal places. Example: 0.65. |
variety | integer | Diversity of generated results. Integer from 0–4, default 1. 0 off, 1 normal, 2 high, 3 extra, 4 max. |
personaId | string | Persona ID or Voice ID to apply to the generated music. |
personaModel | string | Persona model. style_persona or voice_persona. Default: style_persona. |
duration | number | Audio duration in seconds. Range 10–360, default 20. Valid when model is |
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/generate/mashup' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"uploadUrlList": [
"https://example.com/audio1.mp3",
"https://example.com/audio2.mp3"
],
"model": "V4",
"callBackUrl": "https://example.com/callback",
"prompt": "A calm and relaxing piano track with soft melodies",
"style": "Jazz",
"title": "Relaxing Piano",
"vocalGender": "m",
"styleWeight": 0.61,
"weirdnessConstraint": 0.72,
"audioWeight": 0.65,
"lyrics": "[Verse]\nKeep the melody flowing\nInto a gentle bridge\n[Chorus]\nLet the piano rise and fall",
"variety": 1,
"personaId": "persona_123",
"personaModel": "style_persona",
"duration": 20
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}