提交音乐创作任务(核心接口)

Draw

https://drwa.openai-next.com

POST

/_open/suno/music/generate

计费:0.4 积分(任务失败自动退款)

核心创作接口,支持十几种创作模式。提交后立即返回 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`
Mashup(混音)	`metadataParams.mashup_*`
Inspire(灵感曲库)	`metadataParams.inspire_*`
Persona 创作	`personaId`

一次返回 2 首歌

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

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

{
    "inputType": 10,
    "gptDescriptionPrompt": "a happy song about summer",
    "mv": "chirp-v4"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

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

返回响应

🟢200

application/json

任务已提交,返回 taskBatchId 进入轮询

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "您已成功提交创作任务,目前剩余并发任务数为99",
    "data": {
        "taskBatchId": "1261459775314190337",
        "taskStatus": "create",
        "items": [
            {
                "createTime": "2026-05-13T23:10:47.363+08:00",
                "id": "2054580119347007490",
                "inputType": "10",
                "gptDescriptionPrompt": "a happy song about summer",
                "progress": 0,
                "status": 0,
                "progressMsg": "Analyzing your creation..."
            },
            {
                "createTime": "2026-05-13T23:10:47.363+08:00",
                "id": "2054580119347007491",
                "inputType": "10",
                "gptDescriptionPrompt": "a happy song about summer",
                "progress": 0,
                "status": 0,
                "progressMsg": "Analyzing your creation..."
            }
        ]
    }
}

🟠406

修改于 2026-06-16 07:48:47

Query Usage

上传本地参考音频(同步,multipart)