Skip to main content
POST
소스 오디오 참조: 기존 곡을 기반으로 하는 작업에는 추가 ID가 필요 없습니다. 소스 트랙을 만든 작업의 task_iddata.result.music[]에서 결과 트랙을 선택하는 audio_index(1부터 시작, 기본값 1)를 전달하세요.
이 엔드포인트에는 버전 차원이 없습니다: 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).
string
필수
Persona 이름; 누락 시 즉시 400 반환.
string
설명.
string
스타일.
number
음성 클립 시작 시점(초). 0 이상이어야 하며 vocal_end_s와 함께 쓰는 것을 권장합니다.
number
음성 클립 종료 시점(초). 시작 시점보다 크고 알려진 소스 길이를 넘지 않아야 합니다.
완료 후 result.persona_id를 읽습니다. Persona ID는 커스텀 모델 ID와 다르며 model의 API 값으로 쓸 수 없습니다. 새 흐름에서는 미리 Vox를 만들 필요가 없습니다.
결과 조회: 비동기 작업입니다. 제출 후 task_id를 받고 완료될 때까지 3~5초마다 작업을 폴링합니다. 완료 결과에는 Persona 정보가 포함됩니다. 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

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