Skip to main content
POST
소스 오디오 참조: 기존 곡을 기반으로 하는 작업에는 추가 ID가 필요 없습니다. 소스 트랙을 만든 작업의 task_id와 data.result.music[]에서 결과 트랙을 선택하는 audio_index(1부터 시작, 기본값 1)를 전달하세요.

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
교체 구간의 가사.
number
필수
교체 시작 지점(초). 누락 시 즉시 400 반환.
number
필수
종료 시각(초). 0 ≤ start_s < end_s를 만족하고 알려진 소스 길이를 넘지 않아야 합니다.
string
기본값:"v6"
공개 버전: v6 / v6-wild / v6-mini. 기본값은 v6이며 custom_model_id 사용 시 생략하세요.
string
모델 생성 작업이 반환한 전체 UUID. version과 함께 사용할 수 없습니다.
string
컨텍스트 가사.
string
제목.
string
스타일 태그.
string
제외할 스타일 태그.
string
스타일 변화: off / normal / high / extra / max. 선택 사항입니다.
boolean
기본값:"false"
Max 모드를 활성화하며 일반 가격의 2배로 청구됩니다.
string
출력 오디오 형식: mp3 / m4a / wav. 이 엔드포인트는 목표 길이 필드를 지원하지 않습니다.
prompt는 원래 가사 문맥이고 infill_lyrics는 교체할 새 가사입니다. custom, instrumental, auto_lyrics 또는 이전 편집 세션 필드는 보내지 마세요.
결과 조회: 비동기 작업입니다. 제출 후 task_id를 받고 완료될 때까지 3~5초마다 작업을 폴링합니다. 처리 중 상태와 진행률은 고정 간격으로 변하지 않을 수 있습니다. 완료 후 data.result.music[]에서 교체된 트랙의 audio_url을 읽습니다. 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

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