续写歌曲

从已有音轨的指定时间点继续生成后续内容，continue_at 的单位为秒。

music_id 为音轨 ID，可从上传参考音频取得。continue_at 必须大于等于 0。提交后通过查询任务读取结果。

POST/suno/mj/submit/extend

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。

continue_at*number

开始续写的时间点，单位秒；必须大于等于 0。

Range0 <= value

custom*boolean

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

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

auto_lyrics?boolean

是否自动生成歌词。

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/extend' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "continue_at": 62.5,
  "custom": true,
  "prompt": "延续上一段副歌，加入更强的鼓点和合唱",
  "title": "Dusk on Elm Extended",
  "tags": "cinematic pop, choir"
}'

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

Authorization

Request Body

Response Body

200application/json

400application/json

`application/json`

`application/json`