메인 콘텐츠로 건너뛰기
POST

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
version
string
기본값:"v5.5"
생성 버전: v5 / v5.5만 사용 가능; 전달하지 않으면 기본값 v5.5입니다.
prompt
string
필수
음향 효과 텍스트 설명(업스트림 sound에 매핑). 누락된 경우 제출 시 바로 400이 반환됩니다(업스트림 호출 없음, 과금 없음).
type
string
기본값:"one-shot"
음향 효과 유형: one-shot(기본값, 단발) / loop(반복 가능).
bpm
integer
템포, 1300; 범위를 벗어나면 제출 시 바로 400이 반환됩니다.
key
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)을 반환합니다.
결과 가져오기: 본 API는 비동기 작업입니다. 제출 후 task_id를 받아 3~5초 간격으로 GET /v1/music/tasks/{task_id}를 폴링하며, statuscompleted 또는 failed가 될 때까지 대기합니다(생성 중에는 statuspending이고 progress는 대기열 10 → 준비 50 → 완료 100으로 진행됩니다). 완료되면 data.result.music[]에서 audio_url을 가져옵니다. 실패 시 data.error.message에 원인이 표시되며 선차감된 크레딧이 자동으로 환불됩니다.

Response

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