Skip to main content
POST
소스 오디오 참조: 기존 곡을 기반으로 하는 작업에는 추가 ID가 필요 없습니다. 소스 트랙을 만든 작업의 task_id와 data.result.music[]에서 결과 트랙을 선택하는 audio_index(1부터 시작, 기본값 1)를 전달하세요.
extend의 custom은 선택 사항이며 기본값은 true입니다. custom=true이면 prompt에 연장 가사를 넣습니다. custom=false를 명시한 경우에만 gpt_description이 연장 방향을 안내합니다.

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
필수
연장을 시작할 초입니다. 1 이상이고 소스 트랙의 실제 길이보다 작아야 하며 소수 초를 지원합니다.
string
기본값:"v6"
공개 버전: v6 / v6-wild / v6-mini. 기본값은 v6이며 custom_model_id 사용 시 생략하세요.
string
모델 생성 작업이 반환한 전체 UUID. version 및 persona_id와 함께 사용할 수 없습니다.
boolean
기본값:"true"
true= prompt 가사로 연장, false=영감 기반 연장. 생략 시 기본값은 true입니다.
string
확장 부분의 가사. custom=true일 때 적용됩니다.
string
영감 설명. custom=false를 명시한 경우에만 적용되며 연장 방향을 안내합니다.
string
제목. custom=true일 때만 적용됩니다.
string
스타일 태그. custom=true일 때만 적용됩니다.
string
제외할 스타일 태그. custom=true일 때만 적용됩니다.
string
보컬 성별: Male / Female. 두 모드 모두에서 적용됩니다.
number
스타일 가중치, 0.00–1.00(범위를 벗어난 값은 제출 시 바로 400이 반환됩니다). custom=true일 때만 적용됩니다.
number
창의성 가중치, 0.00~1.00. 이전 이름 weirdness_constraint도 지원하지만 새 요청은 weirdness를 사용하세요.
number
오디오 가중치, 0.00–1.00. custom=true일 때만 적용됩니다.
boolean
true=입력한 가사를 바탕으로 2차 창작합니다. custom=true일 때만 적용됩니다.
string
Persona 스타일 ID. custom=true일 때만 적용되며 custom_model_id와 함께 사용할 수 없습니다.
integer
목표 생성 길이, 10~360초. custom=true일 때만 사용할 수 있으며 실제 길이는 결과에 따릅니다.
string
스타일 변화: off / normal / high / extra / max. 선택 사항입니다.
boolean
기본값:"false"
Max 모드를 활성화할지 여부. 활성화하려면 custom=true가 필요하며 일반 가격의 2배로 과금됩니다.
string
출력 오디오 형식: mp3 / m4a / wav.
결과: 비동기 작업입니다. 제출 후 task_id를 받고 완료될 때까지 3~5초마다 작업을 폴링합니다. 완료 후 data.result.music[]에서 연장된 트랙의 audio_url을 읽습니다. 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

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