Skip to main content
POST
소스 오디오 참조: 기존 곡을 기반으로 하는 작업에는 추가 ID가 필요 없습니다. 소스 트랙을 만든 작업의 task_iddata.result.music[]에서 결과 트랙을 선택하는 audio_index(1부터 시작, 기본값 1)를 전달하세요.
custom은 적용되는 필드를 결정합니다. 선택한 모드에서 사용되지 않는 필드라도 제출한 값은 형식, 범위 및 길이 요구 사항을 충족해야 합니다. custom=true이면 prompt를 가사로 사용하며, instrumental=false일 때는 아래 조건에 따라 필수일 수 있습니다. custom=false이면 gpt_description이 필수입니다. custom을 생략하면 백엔드는 prompt, gpt_description, tags, title을 기준으로 모드를 추론합니다.

Authorizations

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

Body

string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
string
필수
원본 작업의 task_id입니다. 반드시 uploadTask 업로드 작업이어야 합니다. 값이 없거나 업로드 작업이 아니거나 원본을 확인할 수 없으면 제출 시 400을 반환합니다.
integer
기본값:"1"
소스 작업의 data.result.music[]에서 트랙을 선택합니다(1부터 시작하며 1이 첫 트랙, 기본값도 1).
number
필수
샘플링 시작 지점(초). 누락되면 즉시 400을 반환합니다.
number
필수
샘플 종료 시각(초). 0 ≤ start_s < end_s를 만족하고 알려진 소스 길이를 넘지 않아야 합니다.
boolean
기본값:"false"
순수 연주곡 여부(true=보컬 없음); 전달하지 않으면 기본값 false(보컬 포함).
string
기본값:"v6"
공개 버전: v6 / v6-wild / v6-mini. 기본값은 v6이며 custom_model_id 사용 시 생략하세요.
string
모델 생성 작업이 반환한 전체 UUID. version과 함께 사용할 수 없습니다.
boolean
true=커스텀 모드(prompt를 가사로 사용); false=영감 모드(gpt_description 사용); 생략하면 콘텐츠로부터 추론됩니다(위의 Warning 참조).
string
조건부 필수: custom=true && instrumental=false인 경우 가사를 제공해야 합니다. 영감 모드에서는 사용되지 않지만, 값을 제출했다면 길이 제한을 충족해야 합니다.
string
영감 프롬프트. custom=false일 때 필수 — 없으면 제출 시점에 400으로 실패합니다(과금되지 않음).
string
제목. custom=true일 때만 적용됩니다.
string
스타일 태그. custom=true일 때만 적용됩니다.
string
제외할 스타일 태그. custom=true일 때만 적용됩니다.
boolean
true=제공된 가사를 창의적으로 다시 씁니다. custom=true일 때만 적용됩니다.
number
스타일 가중치, 0.001.00(범위를 벗어나면 제출 시점에 바로 400을 반환합니다). custom=true일 때만 적용됩니다.
number
창의성 가중치, 0.00~1.00. weirdness_constraint는 호환 별칭이며 새 요청은 weirdness를 사용하세요.
number
오디오 가중치, 0.001.00. custom=true일 때만 적용됩니다.
string
보컬 성별: Male / Female. 두 모드 모두에서 작동합니다.
string
스타일 변화: off / normal / high / extra / max. 선택 사항입니다.
boolean
기본값:"false"
Max 모드를 활성화합니다. 커스텀 모드가 필요하며 일반 가격의 2배로 청구됩니다.
string
출력 오디오 형식: mp3 / m4a / wav. 이 엔드포인트는 목표 길이 필드를 지원하지 않습니다.
소스 작업은 uploadTask 업로드 작업이어야 합니다. start_send_s는 모두 필수이며 서비스가 0이나 60 같은 기본값을 채우지 않습니다.
결과 조회: 비동기 작업입니다. 제출 후 task_id를 받고 statuscompleted 또는 failed가 될 때까지 35초마다 GET /v1/music/tasks/{task_id}를 폴링합니다. 음악 생성은 보통 30120초가 걸리며, 처리 중 statuspending 또는 processing일 수 있고 progress는 0~100의 정수지만 일정 간격으로 변한다고 보장되지 않습니다. 완료 후 data.result.music[]에서 audio_url을 읽습니다. 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

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