创建音乐

OpenAPI Specification

使用指南

此接口根据您的文本提示创建音乐

每个请求会生成多个变体

您可以通过自定义模式和纯音乐设置来控制细节级别

参数说明（task 为 create）

模型（model）：

v40, v45, v45+, v45-lite, v50

自定义模式下（customMode: true）:

makeInstrumental: true：需提供 style 和 title

makeInstrumental: false：需提供 style、prompt 和 title

不同模型的字符限制：

V3_5 和 V4：prompt 3000字符，style 200字符

V4_5 和 V4_5PLUS：prompt 5000字符，style 1000字符

V50：prompt 5000字符，style 1000字符

title 长度限制：80字符（所有模型）

非自定义模式下（customMode: false）:

无论 makeInstrumental 设置如何，仅需提供 prompt

prompt 长度限制：400字符

其他参数应留空

开发者注意事项

新用户建议：以 custom_mode: false 开始使用，更简单

回调过程分三个阶段：text（文本生成）、first（第一首完成）、complete（全部完成）

可选参数

vocalGender（string）: 人声性别偏好。m 男声，f 女声。

styleWeight（number）: 对风格的遵循强度。范围 0–1，保留两位小数。示例：0.65。

weirdnessConstraint（number）: 创意/离散程度。范围 0–1，保留两位小数。示例：0.65。

audioWeight（number）: 音频要素权重。范围 0–1，保留两位小数。示例：0.65。

Authorizations

获取 API Key:访问 API Key 管理页面获取您的
API Key

使用方式:

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

注意事项：

请妥善保管您的 API Key，不要泄露给他人

如果怀疑 API Key 泄露，请立即在管理页面重置

curl --location --request POST '/generator/suno' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "task": "create", "model": "v50", "customMode": true, "makeInstrumental": false, "prompt": "两只老虎两只老虎跑得慢跑得慢一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪两只老虎两只老虎跑得快跑得快一只没有耳朵一只没有尾巴真奇怪真奇怪", "tags": "Happy", "negativeTags": "Sad, Slow", "title": "两只老虎", "vocalGender": "f", "styleWeight": 0.65, "weirdnessConstraint": 0.65, "audioWeight": 0.65 }'

创建音乐

创建音乐

OpenAPI Specification

使用指南

参数说明（task 为 create）

开发者注意事项

可选参数

Authorizations

请求参数

返回响应

创建音乐

创建音乐#

OpenAPI Specification#

使用指南#

参数说明（task 为 create）#

开发者注意事项#

可选参数#

Authorizations#

请求参数

返回响应

创建音乐

OpenAPI Specification

使用指南

参数说明（task 为 create）

开发者注意事项

可选参数

Authorizations