메인 콘텐츠로 건너뛰기
POST
소스 트랙 참조: 기존 곡을 기반으로 하는 작업은 어떤 상위 id도 기억할 필요 없이 task_id(소스 트랙을 생성한 작업의 당사 task_id)와 audio_index(결과 music[]에서 몇 번째 곡인지, 1부터 시작, 기본값 1)만 전달하면 됩니다.
이 API에는 버전 차원이 없습니다: version을 전달하지 마세요 — 전달하더라도 무시되며 과금에 영향을 주지 않습니다.
전제: concatextend(이어쓰기)로 생성된 세그먼트만 이어붙일 수 있습니다. 소스가 extend 산출물이 아니면(예: 일반적으로 한 번에 생성한 완성곡) 제출 시점에 400으로 요청이 거부되며 업스트림이 호출되지 않습니다.

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
task_id
string
필수
소스 작업의 당사 task_id반드시 extend(이어쓰기)로 생성된 세그먼트여야 합니다(위 경고 참조). 누락되었거나, extend 산출물이 아니거나, 소스를 확인할 수 없으면 제출 시점에 400이 반환됩니다.
audio_index
integer
기본값:"1"
소스 작업 결과 data.music[] 중 몇 번째 곡인지(1-based; 기본값 1; 한 번 생성 시 보통 2곡: 인덱스 1과 2).
결과 가져오기: 본 API는 비동기 작업입니다. 제출 후 task_id를 받아 35초 간격으로 GET /v1/music/tasks/{task_id}를 폴링하며, statuscompleted 또는 failed가 될 때까지 대기합니다(보통 30120초 소요; 생성 중에는 statuspending이고 progress는 queued 10 → ready 50 → done 100으로 진행). 완료 시 data.result.music[]에서 완전한 곡의 audio_url을 가져옵니다. 실패 시 data.error.message에 이유가 표시되며 선차감된 크레딧이 자동으로 환불됩니다.

Response

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