生成歌曲(歌手风格)

POST

https://yunwu.ai/suno/submit/music

接入步骤

A. 生成音乐

可以通过场生成歌曲接口生成后，获取其中的一首歌的 clip_id 值为： 54834687-5e79-4f08-8e14-cf188f15b598

B. 新建 Persona

clip_id 需要系统内存在的，非 uploader

不能跨账号，所以可能账号下线用不了

C. 使用 persona_id 创作

注意事项：

mv 为 chirp-v3-5-tau 或者 chirp-v4-tau

task 为 artist_consistency

persona_id 为 B 步骤得到的

artist_clip_id 就是 A 步骤中的 clip_id

可跨账号

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Content-Type

string

必需

示例值:

application/json

string

必需

示例值:

application/json

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数application/json

prompt

string

必需

歌词内容，仅用于自定义模式

string

必需

模型选择，可选 chirp-v3-0、chirp-v3-5，默认为 chirp-v3-0

title

string

必需

歌曲标题，仅用于自定义模式

tags

string

必需

风格标签，仅用于自定义模式，多个标签用半角逗号分隔

make_instrumental

boolean

必需

是否生成纯音乐版本，true 表示生成纯音乐

task_id

string

必需

任务ID，用于对已有任务进行操作（如续写）

continue_at

number

必需

续写起始时间点，浮点数，单位为秒

continue_clip_id

string

需要续写的歌曲ID

必需

gpt_description_prompt

string

必需

创作描述提示词，仅用于灵感模式

notify_hook

string

必需

任务完成后的回调通知地址

示例

{
  "prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "老公",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://yunwu.ai/suno/submit/music' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "老公",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

data

string

必需

message

string

必需

示例

{
    "code": "success",
    "data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
    "message": ""
}

修改于 2025-06-05 18:12:15

生成歌曲(续写模式)

生成歌曲(上传歌曲二次创作)

生成歌曲(歌手风格)

接入步骤#

A. 生成音乐#

B. 新建 Persona#

C. 使用 persona_id 创作#

请求参数

示例代码

返回响应

接入步骤

A. 生成音乐

B. 新建 Persona

C. 使用 persona_id 创作