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