Skip to main content
POST
소스 오디오 참조: 기존 곡을 기반으로 하는 작업에는 추가 ID가 필요 없습니다. 소스 트랙을 만든 작업의 task_iddata.result.music[]에서 결과 트랙을 선택하는 audio_index(1부터 시작, 기본값 1)를 전달하세요.
이 API에는 버전 차원이 없습니다: version을 전달하지 마세요 — 전달하더라도 무시되며 과금에 영향을 주지 않습니다.

Authorizations

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

Body

string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
string
필수
소스 트랙을 생성한 작업의 당사 task_id. 누락되었거나 소스를 확인할 수 없으면 제출 시점에 400이 반환됩니다.
integer
기본값:"1"
소스 작업의 data.result.music[]에서 트랙을 선택합니다(1부터 시작, 기본값 1).
number
필수
배속, 범위 0.254, 예: 1.25. 누락되거나 범위를 벗어난 값은 제출 시점에 바로 400을 반환합니다.
boolean
기본값:"true"
속도 변경 시 원래 음정을 유지할지 여부(기본값 true).
string
기본값:"Untitled"
제목(기본값 Untitled).
결과 조회: 비동기 작업입니다. 제출 후 task_id를 받고 완료될 때까지 35초마다 작업을 폴링합니다. 보통 30120초가 걸리며 처리 중 상태와 진행률은 고정 간격으로 변하지 않을 수 있습니다. 완료 후 data.result.music[]에서 처리된 트랙의 audio_url을 읽습니다. 실패 시 차감 금액은 자동 환불됩니다.

Response

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