生成歌曲

提交新的音乐生成任务，支持灵感模式、自定义模式和纯音乐。

custom 和 instrumental 必须显式传入。custom=false 时填写 gpt_description_prompt；custom=true 且 instrumental=false 时填写 prompt。

提交后保存 data.jobId，通过查询任务读取结果。回调规则见该页的“回调通知”。

POST/suno/mj/submit/music

Authorization

bearerAuth

AuthorizationBearer <token>

使用 Authorization: Bearer your-api-key 认证。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

custom*boolean

是否自定义模式；未传会被拒绝。

instrumental*boolean

是否纯音乐；未传会被拒绝。

mv?string

音乐模型版本；未填写时使用 chirp-v5。

Default"chirp-v5"

Value in

"chirp-v5-5"
"chirp-v5"
"chirp-v4-5+"
"chirp-v4-5"
"chirp-v4-5-all"
"chirp-v4"
"chirp-v3-5"
"chirp-v3-0"

gpt_description_prompt?string

当 custom=false 时必填，长度上限 500 字符。

Lengthlength <= 500

prompt?string

当 custom=true 且 instrumental=false 时必填。

title?string

歌曲标题，长度上限 80 字符。

Lengthlength <= 80

tags?string

风格/标签。

negative_tags?string

负向标签。

style_weight?number

取值范围 0~1。

Range0 <= value <= 1

weirdness_constraint?number

取值范围 0~1。

Range0 <= value <= 1

audio_weight?number

取值范围 0~1。

Range0 <= value <= 1

auto_lyrics?boolean

是否自动生成歌词。

vocal_gender?string

仅支持 Male / Female。

Value in

"Male"
"Female"

persona_id?string

Persona ID。

hookUrl?string

可选的用户回调地址。仅支持 80、443、8080、8443 端口；填写后由平台转发通知。

Response Body

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/music' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "custom": true,
  "instrumental": false,
  "mv": "chirp-v5",
  "prompt": "写一首温暖的民谣流行歌曲，主歌轻柔，副歌有记忆点",
  "title": "Dusk on Elm",
  "tags": "gentle, acoustic pop"
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "JOB_ID"
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`