创建音乐生成任务

POST

/v1/music/generations

请求参数

参数名	类型	必填情况	默认值	描述
`prompt`	string	条件必填	-	非自定义模式下为音乐描述（最多400字符）；自定义歌词模式下为完整歌词内容（V3.5/V4 最大3000字符，V4.5/V4.5+ 最大5000字符）
`model`	string	否	"suno-v4.5-plus"	模型版本，可选值：suno-v3.5、suno-v4、suno-v4.5、suno-v4.5-plus
`style`	string	自定义模式必填	-	音乐风格（V3.5/V4 最大200字符，V4.5/V4.5+ 最大1000字符）
`title`	string	自定义模式必填	-	音乐标题，最大80字符
`instrumental`	boolean	否	false	是否为纯音乐，true 表示纯音乐，false 表示有人声
`custom_mode`	boolean	否	false	是否使用自定义模式，true 为自定义模式，false 为非自定义模式
`negative_tags`	string	否	-	需要排除的风格标签
`vocal_gender`	string	否	-	人声性别，可选值："m"（男性）、"f"（女性）
`style_weight`	float	否	-	风格权重，取值范围 0.0-1.0
`weirdness_constraint`	float	否	-	创意发散度，取值范围 0.0-1.0
`audio_weight`	float	否	-	音频影响力权重，取值范围 0.0-1.0

请求参数

Header 参数

Body 参数application/json

示例

{
  "prompt": "一首关于春天的轻快J-Pop歌曲",
  "model": "suno-v4.5-plus",
  "custom_mode": false
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v1/music/generations' \
--header 'Authorization: {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "一首关于春天的轻快J-Pop歌曲",
  "model": "suno-v4.5-plus",
  "custom_mode": false
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "created": 1755616949,
    "data": [
        {
            "id": "task-id-here",
            "status": "processing"
        }
    ]
}

修改于 2025-10-24 06:52:06

音频转文本

查询音乐生成任务