上传并翻唱音乐
POST
/api/v1/client/tasks
覆盖音乐样式
参数使用指南
字符限制
style（最大 1000 字符）、title（最大 80 字符）、lyrics / prompt（最大 5000 字符）uploadUrl）即可生成；lyrics（原 prompt）、title、style 非必传uploadUrl、modellyrics 优先于 prompt 作为歌词；未传 lyrics 时，若提供了 prompt 则将 prompt 作为歌词uploadUrl 用于指定源音频文件。请确保上传的音频长度不超过 8 分钟。开发者注意事项
1.
2.
lyrics、prompt、style 和 title 的字符长度限制，确保成功处理。3.
text（文本生成完成）、first（第一首完成）、complete（全部完成）。4.
5.
uploadUrl 参数用于指定音频文件的上传位置；请提供有效的 URL。可选参数
| 参数名 | 类型 | 说明 |
|---|---|---|
lyrics | string | 歌词内容。可选。优先于 prompt 作为歌词。V6 最多 5000 字符。 |
prompt | string | 未传 lyrics 时作为歌词。可选。V6 最多 5000 字符。 |
style | string | 音乐风格。可选。V6 最多 1000 字符。 |
title | string | 曲目标题。可选。最多 80 字符。 |
variety | integer | 生成结果多样性。0–4 的整数，默认 1。0 关 / 1 普通 / 2 高 / 3 额外 / 4 最大。 |
vocalGender | string | 人声性别偏好。m 代表男声，f 代表女声。 |
styleWeight | number | 对风格的遵循强度。范围 0–1，保留两位小数。示例：0.65。 |
weirdnessConstraint | number | 创意/离散程度控制。范围 0–1，保留两位小数。示例：0.65。 |
audioWeight | number | 音频要素权重。范围 0–1，保留两位小数。示例：0.65。 |
personaId | string | 应用到生成音乐的 Persona ID 或 Voice ID。生成 Persona ID 请访问 生成 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/upload-and-cover-audio",
"callBackUrl": "https://api.example.com/callback",
"input": {
"uploadUrl": "https://api.example.com/upload",
"prompt": "一段平静舒缓的钢琴曲，带有柔和的旋律",
"lyrics": "[主歌]\n让旋律继续流淌\n走进一段柔和的过渡\n[副歌]\n钢琴起伏回旋",
"style": "古典",
"title": "宁静钢琴冥想",
"instrumental": true,
"model": "V6",
"negativeTags": "重金属, 强节奏鼓点",
"vocalGender": "m",
"styleWeight": 0.65,
"weirdnessConstraint": 0.65,
"audioWeight": 0.65,
"variety": 1,
"personaId": "persona_123",
"personaModel": "voice_persona",
"duration": 20
}
}'Response Response Example
{
"msg": "Playground task completed successfully.",
"code": 200,
"data": {
"resultJson": "{\"sunoData\":[{\"duration\":30.04,\"stream_audio_url\":\"https://cdn1.suno.ai/231a2348-2d4a-4ad2-a02a-dabd6ce49271.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-fenix\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/73c347ebdf5740fcb64d7dbafce45751.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/9daea8287dc6439b8649e9f849317d45.mp3\",\"id\":\"231a2348-2d4a-4ad2-a02a-dabd6ce49271\",\"title\":\"Summer Vibes Cover\",\"prompt\":\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\",\"tags\":\"Pop, Electronic, Uplifting\"},{\"duration\":30.04,\"stream_audio_url\":\"https://cdn1.suno.ai/553a46f1-faea-46a3-b2c1-9865153f7ce1.mp3\",\"image_suno_watermark\":false,\"model_name\":\"chirp-fenix\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/dc4ddc0f467b419ba3d22c0ef3ce7243.jpeg\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/773ad72c9dd44feeb414e7eca6a32f95.mp3\",\"id\":\"553a46f1-faea-46a3-b2c1-9865153f7ce1\",\"title\":\"Summer Vibes Cover\",\"prompt\":\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\",\"tags\":\"Pop, Electronic, Uplifting\"}]}",
"param": "{\"model\": \"suno/upload-and-cover-audio\", \"input\": \"{\\\"model\\\": \\\"V5_5\\\", \\\"uploadUrl\\\": \\\"https://tempfileb.aiquickdraw.com/kieai/market/1786351570493_fUqB0L0k.mp3\\\", \\\"instrumental\\\": false, \\\"prompt\\\": \\\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\\\", \\\"duration\\\": 30, \\\"style\\\": \\\"Pop, Electronic, Uplifting\\\", \\\"title\\\": \\\"Summer Vibes Cover\\\", \\\"continueAt\\\": 7, \\\"negativeTags\\\": \\\"heavy metal, aggressive, dark\\\", \\\"vocalGender\\\": \\\"f\\\", \\\"styleWeight\\\": 0.7, \\\"weirdnessConstraint\\\": 0.5, \\\"audioWeight\\\": 0.6, \\\"variety\\\": 1}\", \"callBackUrl\": \"http://localhost:8305/test\"}",
"costTime": 102,
"createTime": 1786352250000,
"completeTime": 1786352368000,
"model": "suno/upload-and-cover-audio",
"updateTime": 1786352368000,
"state": "success",
"creditsConsumed": 12,
"taskId": "d53d3d23191ca0631fd02f746850055b"
}
}