메인 콘텐츠로 건너뛰기
POST
소스 트랙 참조: 이 엔드포인트는 task_id + audio_index사용하지 않습니다. 공개적으로 접근 가능한 audio_url을 직접 전달해야 합니다(업스트림이 여기서 음색을 추출). 없으면 400 audio_url cannot be empty 반환.
이 엔드포인트에는 버전 차원이 없습니다: version을 전달하지 마세요 — 전달하더라도 무시되며 과금에 영향을 주지 않습니다.

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
audio_url
string
필수
소스 트랙의 공개 접근 가능한 URL. 업스트림이 여기서 음색을 추출합니다. MP3 / WAV만 허용됩니다. 없으면 400 audio_url cannot be empty 반환.
결과 가져오기: 본 API는 비동기 작업입니다. 제출 후 task_id를 받아 35초 간격으로 GET /v1/music/tasks/{task_id}를 폴링하며, statuscompleted 또는 failed가 될 때까지 대기합니다(보통 30120초; 생성 중에는 statuspending이며 progress는 대기 10 → 준비 50 → 완료 100으로 진행). 결과에 생성된 음색 정보가 포함됩니다. 실패 시 data.error.message가 원인을 제공하며 선차감된 크레딧이 자동으로 환불됩니다.

Response

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