Skip to main content
POST
custom은 텍스트 필드 해석 방식을 제어합니다. custom=true(커스텀 모드)에서는 prompt에 가사를 넣고 title, style, negative_tags, auto_lyrics, persona_id가 적용됩니다. custom=false(영감 모드)에서는 prompt에 영감 설명을 넣으며 위 커스텀 모드 필드는 무시됩니다. style_weight, weirdness_constraint, audio_weight, vocal_gender는 두 모드 모두에서 검증되고 적용됩니다.
이 엔드포인트는 필드 이름이 약간 다르며 tags 대신 style을 사용합니다.

Authorizations

string
필수
모든 API는 Bearer Token을 사용한 인증이 필요합니다API Key 발급:API Key 관리 페이지에 접속하여 API Key를 발급받으세요사용 시 요청 헤더에 추가하세요:

Body

string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
boolean
기본값:"false"
false=영감 모드; true=커스텀 모드(prompt를 가사로 사용). 기본값은 false입니다.
boolean
기본값:"false"
true=순수 연주곡, 보컬 없음. 기본값은 false입니다.
string
공개 버전: v6 / v6-wild / v6-mini. custom_model_id와 둘 중 하나는 반드시 제공해야 하며 커스텀 모델 사용 시 이 필드를 생략하세요.
string
생성된 커스텀 모델 작업의 전체 UUID. version 및 persona_id와 함께 사용할 수 없으며, 이 필드를 제공하면 커스텀 모델 가격 등급으로 과금됩니다.
string
영감 설명/가사. custom=false이면 필수이며 최대 3,000자입니다. custom=true이고 instrumental=false일 때도 필수이며 최대 5,000자입니다. 커스텀 연주곡에서는 생략할 수 있습니다.
string
커스텀 모드 제목, 최대 80자. custom=false(영감 모드)에서는 무시됩니다.
string
스타일 태그(커스텀 모드), 최대 1,000자. custom=false(영감 모드)에서는 무시됩니다.
string
부정 스타일 태그(원하지 않는 스타일). custom=true일 때만 적용됩니다.
boolean
true=입력한 가사를 바탕으로 2차 창작합니다. custom=true일 때만 적용됩니다.
string
Persona 스타일 ID. custom=true일 때만 적용되며 custom_model_id와 함께 사용할 수 없습니다.
string
보컬 성별: Male / Female(m / f / male / female도 허용되며 백엔드에서 자동으로 정규화됩니다). 두 모드 모두에서 적용됩니다.
number
스타일 가중치, 0.00~1.00. 두 모드 모두에서 검증되고 적용됩니다.
number
창의성 점수, 0.00~1.00. 두 모드 모두에서 검증되고 적용됩니다.
number
오디오 가중치, 0.00~1.00. 두 모드 모두에서 검증되고 적용됩니다.
string
스타일 변화: off / normal / high / extra / max. 선택 사항이며 고정 기본값은 없습니다.
boolean
기본값:"false"
Max 모드를 활성화할지 여부. 활성화하려면 custom=true가 필요하며 일반 가격의 2배로 과금됩니다.
string
출력 오디오 형식: mp3 / m4a / wav. 생략하면 서비스 기본값을 사용합니다.
integer
목표 생성 길이, 10~360초. custom=true일 때만 사용할 수 있으며 실제 결과물 길이는 작업 결과에 따릅니다.
결과 조회: 비동기 작업입니다. 제출 후 task_id를 받고 status가 completed 또는 failed가 될 때까지 35초마다 GET /v1/music/tasks/{task_id}를 폴링합니다. 음악 생성은 보통 30120초가 걸리며, 처리 중 status는 pending 또는 processing일 수 있고 progress는 0~100의 정수지만 일정 간격으로 변한다고 보장되지 않습니다. 완료 후 data.result.music[]에서 audio_url을 읽습니다(image_url, video_url, title, duration 등도 포함). 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

integer
응답 상태 코드
array
반환 데이터 배열