Add Vocals to Music
POST
/api/v1/client/tasks
Usage Guide
uploadUrl), generation can proceed; title, negativeTags, and style are required; other parameters are optionalParameter Details
uploadUrl, title, negativeTags, styleuploadUrl specifies the audio file URL to be processedprompt defines lyric content and singing style (optional)lyrics is optional lyrics content (V6 maximum 5000 characters)model specifies the AI model versionstyle and negativeTags are used to control music and vocal stylevariety controls result diversity (integer 0–4, default 1)Developer Notes
text (text generation), first (first track completed), complete (all completed)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/add-vocals",
"callBackUrl": "https://example.com/callback",
"input": {
"uploadUrl": "https://example.com/music.mp3",
"prompt": "A calm and relaxing piano track.",
"lyrics": "[Verse]\nKeep the melody flowing\nInto a gentle bridge\n[Chorus]\nLet the piano rise and fall",
"model": "V6",
"title": "Relaxing Piano",
"negativeTags": "heavy metal, strong drum beats",
"style": "Jazz",
"vocalGender": "m",
"styleWeight": 0.61,
"weirdnessConstraint": 0.72,
"audioWeight": 0.65,
"variety": 1
}
}'Response Response Example
{
"msg": "Playground task completed successfully.",
"code": 200,
"data": {
"resultJson": "{\"sunoData\":[{\"duration\":160.92,\"stream_audio_url\":\"https://cdn1.suno.ai/5ba2cca7-5dc8-4447-89e3-43c7cc06c20a.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-fenix\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/30829750e7954e15a7274419a355cb2b.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/e905ae2fed914b4eac49e03bcb589e62.mp3\",\"id\":\"5ba2cca7-5dc8-4447-89e3-43c7cc06c20a\",\"title\":\"test\",\"prompt\":\"高亢激昂的人声\",\"tags\":\"classical\"},{\"duration\":172.52,\"stream_audio_url\":\"https://cdn1.suno.ai/c286ad3f-575e-4d3a-820b-2d98ec4ad006.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-fenix\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/e8ee0d1990cf448f9e67877b35dc60c0.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/a58764eeb3e74d0581d847063c47c59f.mp3\",\"id\":\"c286ad3f-575e-4d3a-820b-2d98ec4ad006\",\"title\":\"test\",\"prompt\":\"高亢激昂的人声\",\"tags\":\"classical\"}]}",
"param": "{\"model\":\"suno/add-vocals\",\"callBackUrl\":\"http://localhost:8305/test\",\"input\":\"{\\\"model\\\":\\\"V5_5\\\",\\\"uploadUrl\\\":\\\"https://tempfileb.aiquickdraw.com/kieai/market/1786416543295_UQTBOrnT.mp3\\\",\\\"prompt\\\":\\\"高亢激昂的人声\\\",\\\"title\\\":\\\"test\\\",\\\"negativeTags\\\":\\\"pop\\\",\\\"style\\\":\\\"classical\\\",\\\"vocalGender\\\":\\\"f\\\",\\\"styleWeight\\\":0.65,\\\"weirdnessConstraint\\\":0.65,\\\"audioWeight\\\":0.65}\"}",
"costTime": 184,
"createTime": 1786416960000,
"completeTime": 1786417153000,
"model": "suno/add-vocals",
"updateTime": 1786417153000,
"state": "success",
"creditsConsumed": 12,
"taskId": "d70c863e4a43c6d08e6828f4b78e992d"
}
}