노래 생성

새 음악 생성 작업을 제출하며 영감 모드, 사용자 정의 모드 및 연주곡을 지원합니다.

custom과 instrumental은 명시적으로 전달해야 합니다. custom=false이면 gpt_description_prompt를 입력하고 custom=true이고 instrumental=false이면 prompt를 입력합니다.

제출 후 data.jobId를 저장하고 작업 조회로 결과를 읽습니다. 콜백 규칙은 해당 페이지의 “콜백 알림”을 참고합니다.

POST/suno/mj/submit/music

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

custom*boolean

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

instrumental*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이고 instrumental=false일 때 필수입니다.

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

auto_lyrics?boolean

가사 자동 생성 여부입니다.

vocal_gender?string

Male / Female만 지원합니다.

허용 값

"Male"
"Female"

persona_id?string

Persona ID입니다.

hookUrl?string

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

응답 본문

`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"
  }
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`