보컬 추가

먼저 참조 오디오 업로드로 트랙 ID를 받고 music_id에 입력합니다. 노래 생성에서 반환된 트랙 ID는 이 작업에 사용할 수 없습니다.

custom=true이면 prompt는 가사 또는 보컬 프롬프트입니다. 제출 성공 후 data.jobId를 저장하고 작업 조회로 결과를 기다립니다. 제출 응답의 status: SUCCESS는 오디오 생성 완료를 의미하지 않습니다.

POST/suno/mj/submit/add-vocals

인증

bearerAuth

인증Bearer <token>

Authorization: Bearer your-api-key로 인증합니다.

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

music_id*string

참조 오디오 업로드로 받은 트랙 ID입니다. 노래 생성에서 반환된 트랙 ID는 이 작업에 사용할 수 없습니다.

custom*boolean

사용자 정의 모드 여부이며 전달하지 않으면 거부됩니다.

mv?string

음악 모델 버전이며 생략하면 chirp-v5를 사용합니다.

기본값"chirp-v5"

허용 값

"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자입니다.

길이length <= 500

prompt?string

custom=true일 때 필수이며 가사 또는 보컬 프롬프트로 사용합니다.

title?string

제목이며 최대 길이는 80자입니다.

길이length <= 80

tags?string

음악 스타일입니다.

negative_tags?string

제외할 태그입니다.

style_weight?number

각 값의 범위는 0~1입니다.

범위0 <= value <= 1

weirdness_constraint?number

각 값의 범위는 0~1입니다.

범위0 <= value <= 1

audio_weight?number

각 값의 범위는 0~1입니다.

범위0 <= value <= 1

vocal_gender?string

Male / Female만 지원합니다.

허용 값

"Male"
"Female"

isStorage?boolean

별도 저장 여부입니다.

hookUrl?string

선택적 사용자 콜백 주소입니다. 80, 443, 8080, 8443 포트만 지원하며 입력하면 플랫폼이 알림을 전달합니다.

응답 본문

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/add-vocals' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": true,
  "mv": "chirp-v5",
  "prompt": "이 멜로디에 따뜻한 중국어 여성 보컬의 벌스와 후렴을 추가해 주세요",
  "title": "Voice Layer",
  "tags": "mandopop, female vocal",
  "vocal_gender": "Female"
}'

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

인증

요청 본문

응답 본문

200application/json

400application/json

`application/json`

`application/json`