가사 생성

프롬프트를 기준으로 가사 후보를 생성하고 작업 조회로 결과를 받습니다.

제출 성공 후 data.jobId를 저장하고 작업 조회로 가사 후보를 받습니다. lyrics_model은 classic과 remi를 지원하며 생략하면 classic을 사용합니다.

작업 조회에서 완료가 확인되면 가사 후보는 응답의 data.data.data.lyrics에 있습니다. 각 항목은 prompt로 전체 가사를 반환하며 title과 tags를 포함합니다. 반환되지 않은 text 필드를 읽지 않습니다.

POST/suno/mj/submit/lyrics

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

prompt*string

가사 생성 프롬프트이며 최대 길이는 500자입니다.

길이length <= 500

lyrics_model?string

가사 모델이며 classic과 remi를 지원합니다. 기본값은 classic입니다.

기본값"classic"

허용 값

"classic"
"remi"

hookUrl?string

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

응답 본문

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/lyrics' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "여름밤 해변에서의 재회를 주제로 중국어 팝 가사를 작성해 주세요. 후렴은 기억에 남도록 해 주세요",
  "lyrics_model": "classic"
}'

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

인증

요청 본문

응답 본문

200application/json

400application/json

429application/json

`application/json`

`application/json`

`application/json`