메인 콘텐츠로 건너뛰기
POST
소스 트랙 참조: 기존 곡을 기반으로 하는 작업은 어떤 상위 id도 기억할 필요 없이 task_id(소스 트랙을 생성한 작업의 당사 task_id)와 audio_index(결과 music[]에서 몇 번째 곡인지, 1부터 시작, 기본값 1)만 전달하면 됩니다.
extend에서는 custom이 필수도 아니고 추론되지도 않습니다 — 생략해도 확장은 정상 동작합니다; 전달하면 그대로 업스트림에 전달됩니다. custom=trueprompt 가사를 따라 확장하고, custom=false 또는 생략 시 gpt_description(영감 프롬프트)을 전달해 확장 방향을 유도할 수 있습니다.

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
task_id
string
필수
소스 트랙을 생성한 작업의 당사 task_id. 누락되었거나 소스를 확인할 수 없는 경우 제출 시 바로 400이 반환됩니다.
audio_index
integer
기본값:"1"
소스 작업 결과 data.music[] 중 몇 번째 곡인지(1-based; 기본값 1; 한 번 생성 시 보통 2곡: 인덱스 1과 2).
continue_at
integer
필수
몇 초 지점부터 이어서 작성할지.
version
string
기본값:"v5.5"
생성 버전: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, 음질과 과금에 영향을 미칩니다; 전달하지 않으면 기본값 v5.5를 사용하며, 유효하지 않은 값은 제출 시 바로 400이 반환됩니다.
custom
boolean
전달할 필요가 없습니다(extend에서는 강제되지 않음). true=prompt 가사를 따라 확장; false=영감 기반 확장.
prompt
string
확장 부분의 가사. custom=true일 때 적용됩니다.
gpt_description
string
영감 프롬프트. custom=false이거나 custom을 생략했을 때 적용됩니다(확장 방향을 유도).
title
string
제목. custom=true일 때만 적용됩니다.
tags
string
스타일 태그. custom=true일 때만 적용됩니다.
negative_tags
string
제외할 스타일 태그. custom=true일 때만 적용됩니다.
vocal_gender
string
보컬 성별: Male / Female. 두 모드 모두에서 적용됩니다.
style_weight
number
스타일 가중치, 0.001.00(범위를 벗어난 값은 제출 시 바로 400이 반환됩니다). custom=true일 때만 적용됩니다.
weirdness_constraint
number
창의성 가중치, 0.001.00(별칭 weirdness). custom=true일 때만 적용됩니다.
audio_weight
number
오디오 가중치, 0.001.00. custom=true일 때만 적용됩니다.
auto_lyrics
boolean
true=입력한 가사를 바탕으로 2차 창작합니다. custom=true일 때만 적용됩니다.
persona_id
string
Persona 스타일 id. custom=true일 때만 적용됩니다.
결과 가져오기: 본 API는 비동기 작업입니다. 제출 후 task_id를 받아 35초 간격으로 GET /v1/music/tasks/{task_id}를 폴링하며, statuscompleted 또는 failed가 될 때까지 대기합니다(음악 생성은 보통 30120초; 생성 중에는 statuspending이고 progress는 대기열 10 → 준비 50 → 완료 100으로 진행됩니다). 완료되면 data.result.music[]에서 연장된 audio_url을 가져옵니다. 실패 시 data.error.message에 원인이 표시되며 선차감된 크레딧이 자동으로 환불됩니다.

Response

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