提交音乐

POST

/suno/music/generate

提交后立即返回 taskBatchId, 需轮询 /getState 直到 taskStatus=finished,再从 data.items[] 中取 cld2AudioUrl。

支持的创作模式

通过不同的字段组合实现:

模式	关键字段
灵感模式	`inputType=10` + `gptDescriptionPrompt`
自定义模式	`inputType=20` + `prompt` + `tags` + `title`
续写	`continueClipId` + `continueAt`
Cover(换风格)	`coverClipId`
Remaster(音质提升)	`metadataParams.remaster=true`
AddInstrumental(加伴奏)	`metadataParams.underpainting_clip_id`
AddVocals(加人声)	`metadataParams.overpainting_clip_id`
Sample(参考片段)	`metadataParams.chop_sample_clip_id`

生成数量

Suno 默认一次任务生成 2 首歌,体现为 data.items[] 长度为 2。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

cURL

灵感模式 — 用一句话描述生成歌曲自定义模式 — 完整指定歌词、风格、标题在已有歌曲上续写直接通过音频 URL 续写把一首歌转成新风格,保持旋律生成无人声纯音乐(伴奏)给一段清唱加伴奏给一段纯音乐填词加人声根据短片段/哼唱扩写成完整歌曲

curl --location 'https://api.uniapi.io/suno/music/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "inputType": 10,
    "gptDescriptionPrompt": "a happy song about summer",
    "mv": "chirp-v4"
}'

响应示例

{
    "code": 200,
    "msg": "您已成功提交创作任务，目前剩余并发任务数为99",
    "data": {
        "taskBatchId": "1261719676955385857",
        "taskStatus": "create",
        "items": [
            {
                "id": "2054840020958945282",
                "inputType": "20",
                "prompt": "xxxxxxx",
                "progressMsg": "Analyzing your creation...",
                "createTime": "2026-05-14T16:23:32.735+08:00"
            },
            {
                "id": "2054840020958945283",
                "inputType": "20",
                "prompt": "xxxxxx",
                "progressMsg": "Analyzing your creation...",
                "createTime": "2026-05-14T16:23:32.735+08:00"
            }
        ]
    }
}

修改于 2026-05-14 10:12:51

查询单个任务

生成歌词

提交音乐

支持的创作模式#

生成数量#

请求参数

返回响应

支持的创作模式

生成数量