风格翻唱

基于已有音轨或上传参考音频得到的音轨 ID，转换音乐风格、歌词或声线。

先通过上传参考音频取得音轨 ID，或使用已有音轨的 ID，填入 music_id。提交后通过查询任务读取结果。

POST/suno/mj/submit/cover

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

music_id*string

要翻唱的音轨 ID，可来自上传参考音频接口。

custom*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 时必填。

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

vocal_gender?string

仅支持 Male / Female。

Value in

"Male"
"Female"

persona_id?string

Persona ID。

isStorage?boolean

是否转存。

hookUrl?string

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

Response Body

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/cover' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": false,
  "mv": "chirp-v5",
  "gpt_description_prompt": "把这段参考音频改成复古 synth-pop 女声风格，保留旋律记忆点",
  "title": "Neon Cover",
  "tags": "synth-pop, retro, female vocal"
}'

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

Authorization

Request Body

Response Body

200application/json

`application/json`