Skip to main content
POST
연장과 업로드
4개 작업이 동일 엔드포인트를 공유하며 {operation}이 동작을 결정합니다:

Authorizations

string
필수
Bearer Token. API Key:API Key 관리 페이지

extend — 곡 연장(0.05,Max0.05, Max 0.10)

기존 태스크의 지정 시점부터 이어서 생성. custom은 기본 true.
string
필수
고정 "suno"
string
필수
원본 태스크 ID
number
필수
재개 위치(초)
number
트랙 번호
string
이어질 가사(custom 모드)
string
제목
string
스타일 태그
boolean
Max 티어 $0.10

uploadTask — 업로드 등록($0.004)

공개 오디오 URL을 태스크로 등록. 산출물은 sample/addVocals/addInstrumental/addStem의 필수 소스입니다.
string
필수
고정 "suno"
string
필수
공개 접근 가능한 오디오 URL
model + audioFilePath만 전송. version 등 불필요한 필드는 업스트림에서 거부됩니다.

uploadCover — 업로드+커버(0.05,Max0.05, Max 0.10)

string
필수
고정 "suno"
string
필수
원본 오디오 URL
boolean
커스텀 가사 모드
string
가사(custom=true) / 설명
string
영감 설명(custom=false일 때 필수)
string
목표 스타일
string
보컬 페르소나. custom_model_id와 상호 배타
boolean
Max 티어

uploadExtend — 업로드+연장(0.05,Max0.05, Max 0.10)

오디오를 업로드하고 지정 시점부터 연장. 항상 커스텀 모드로 처리.
string
필수
고정 "suno"
string
필수
원본 오디오 URL
number
필수
재개 위치(초)
string
이어질 가사
string
스타일
boolean
Max 티어

Response

string
태스크 ID
string
submitted