Skip to main content
POST

Authorizations

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

Body

string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
string
기본값:"v6"
공개 버전: v6 / v6-wild / v6-mini. 생략 시 기본값은 v6입니다.
string
필수
음향 효과 텍스트 설명. 누락된 경우 제출 시 바로 400이 반환됩니다(과금 없음). 더 나은 결과를 위해 되도록 영어 프롬프트를 사용하는 것을 권장합니다.
string
기본값:"one-shot"
음향 효과 유형: one-shot(기본값, 단발) / loop(반복 가능).
integer
템포, 1–300; 범위를 벗어나면 제출 시 바로 400이 반환됩니다.
string
조성(Key) 열거값: 장조 C / C# / D / D# / E / F / F# / G / G# / A / A# / B; 단조는 뒤에 m을 붙입니다(Cm / C#m / … / Bm). 샤프(#) 표기만 지원하며, 플랫(Db / Eb 등)과 B#는 400(key param error)을 반환합니다.
string
출력 오디오 형식: mp3 / m4a / wav.
이 API는 커스텀 모델, Max, variety, 목표 길이 필드를 지원하지 않습니다.
결과 조회: 이 API는 비동기 작업입니다. 제출 후 task_id를 받고 status가 completed 또는 failed가 될 때까지 35초마다 GET /v1/music/tasks/{task_id}를 폴링합니다. 처리 중 status는 pending 또는 processing일 수 있으며 progress는 0100의 정수이지만 일정 간격으로 변한다고 보장되지 않습니다. 완료 후 data.result.music[]에서 audio_url을 읽습니다. 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

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