메인 콘텐츠로 건너뛰기
POST
본 API에는 버전 차원이 없습니다: version을 전달하지 마세요. 전달해도 폐기되며, 과금에도 영향을 주지 않습니다.
알려진 제한: 순수 연주(보컬 없음) 오디오를 업로드하지 마세요. 업스트림에서 파싱에 실패할 수 있습니다.

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
audioFilePath
string
필수
공개적으로 접근 가능한 오디오 직접 링크. 누락된 경우 제출 시 바로 400이 반환됩니다(업스트림 호출 없음, 과금 없음).
결과 가져오기: 본 API는 비동기 작업입니다. 제출 후 task_id를 받아 3~5초 간격으로 GET /v1/music/tasks/{task_id}를 폴링하며, statuscompleted 또는 failed가 될 때까지 대기합니다(생성 중에는 statuspending이고 progress는 대기열 10 → 준비 50 → 완료 100으로 진행됩니다). 완료 후 본 작업의 task_id + audio_index=1을 다른 작업의 소스로 사용합니다. 실패 시 data.error.message에 원인이 표시되며 선차감된 크레딧이 자동으로 환불됩니다.

Response

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