Viết tiếp bài hát

Tiếp tục tạo nội dung từ một thời điểm chỉ định trong bản nhạc có sẵn; đơn vị của continue_at là giây.

music_id là ID bản nhạc, có thể lấy từ Tải lên âm thanh tham chiếu. continue_at phải lớn hơn hoặc bằng 0. Sau khi gửi, đọc kết quả qua Truy vấn tác vụ.

POST/suno/mj/submit/extend

Xác thực

bearerAuth

Xác thựcBearer <token>

Xác thực bằng Authorization: Bearer your-api-key.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

music_id*string

ID bản nhạc cần viết tiếp.

continue_at*number

Thời điểm bắt đầu viết tiếp, tính bằng giây; phải lớn hơn hoặc bằng 0.

Phạm vi0 <= value

custom*boolean

Có sử dụng chế độ tùy chỉnh hay không; yêu cầu bị từ chối nếu không truyền.

gpt_description_prompt?string

Bắt buộc khi custom=false, tối đa 500 ký tự.

Độ dàilength <= 500

prompt?string

Bắt buộc khi custom=true, dùng làm lời bài hát viết tiếp hoặc lời nhắc.

title?string

Tiêu đề, tối đa 80 ký tự.

Độ dàilength <= 80

tags?string

Phong cách âm nhạc.

negative_tags?string

Thẻ loại trừ.

style_weight?number

Các giá trị đều nằm trong phạm vi 0~1.

Phạm vi0 <= value <= 1

weirdness_constraint?number

Các giá trị đều nằm trong phạm vi 0~1.

Phạm vi0 <= value <= 1

audio_weight?number

Các giá trị đều nằm trong phạm vi 0~1.

Phạm vi0 <= value <= 1

auto_lyrics?boolean

Có tự động tạo lời bài hát hay không.

vocal_gender?string

Chỉ hỗ trợ Male / Female.

Giá trị được phép

"Male"
"Female"

persona_id?string

Persona ID。

isStorage?boolean

Có lưu chuyển sang nơi lưu trữ khác hay không.

hookUrl?string

Địa chỉ callback tùy chọn của người dùng. Chỉ hỗ trợ các cổng 80, 443, 8080, 8443; khi điền, nền tảng chuyển tiếp thông báo.

Nội dung phản hồi

`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": "Tiếp nối điệp khúc trước đó, thêm nhịp trống mạnh hơn và phần hợp xướng",
  "title": "Dusk on Elm Extended",
  "tags": "cinematic pop, choir"
}'

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

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

`application/json`

`application/json`