Generate Mashup Music
POST
/api/v1/jobs/createTask
Document updated
Create remix music using AI models by combining multiple audio tracks.
Usage Guide
upload_url_list must contain 2 audio URLs. Upstream uses only the first 2.Parameter Details
upload_url_list, model, style, titlelyrics is optional and takes priority over prompt as lyrics. If lyrics is omitted, prompt is used as lyrics when providedprompt 3000 characters, style 200 characters, title 80 charactersprompt 5000 characters, style 1000 characters, title 100 charactersprompt 5000 characters, style 1000 characters, title 80 charactersprompt 5000 characters, style 1000 characters, title 100 characterslyrics / prompt 5000 characters, style 1000 characters, title 100 charactersDeveloper Notes
text (text generation), first (first track complete), complete (all complete).upload_url_list 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. |
vocal_gender | 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. |
style_weight | number | Strength of adherence to style. Range is 0–1, with two decimal places. Example: 0.61. |
weirdness_constraint | number | Creativity/discreteness level. Range is 0–1, with two decimal places. Example: 0.72. |
audio_weight | 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. |
persona_id | string | Persona ID or Voice ID to apply to the generated music. |
persona_model | 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/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ai-music-api/mashup",
"callBackUrl": "https://example.com/callback",
"input": {
"upload_url_list": [
"https://example.com/audio1.mp3",
"https://example.com/audio2.mp3"
],
"model": "V4",
"prompt": "A calm and relaxing piano track with soft melodies",
"style": "Jazz",
"title": "Relaxing Piano",
"vocal_gender": "m",
"style_weight": 0.61,
"weirdness_constraint": 0.72,
"audio_weight": 0.65,
"lyrics": "[Verse]\nKeep the melody flowing\nInto a gentle bridge\n[Chorus]\nLet the piano rise and fall",
"variety": 1,
"persona_id": "persona_123",
"persona_model": "style_persona",
"duration": 20
}
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}