메인 콘텐츠로 건너뛰기
POST
custom는 어떤 필드가 적용되는지를 결정합니다: 모드와 일치하지 않는 필드는 업스트림에서 조용히 무시됩니다(오류 없음). custom=true(커스텀)일 때 prompt(가사), title, style, negative_tags, auto_lyrics, persona_id, style_weight, weirdness_constraint, audio_weight가 적용됩니다; custom=false(영감)일 때 prompt는 영감 설명으로 사용되며, title/style 및 위의 커스텀 필드는 무시됩니다. vocal_gender는 두 모드 모두에서 적용됩니다.
본 엔드포인트는 별도의 라우트를 사용하므로 일부 필드 이름이 다른 엔드포인트와 다릅니다: style(tags 아님).

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
custom
boolean
기본값:"false"
false=영감 모드; true=커스텀 모드(prompt를 가사로 사용). 기본값은 false입니다.
instrumental
boolean
기본값:"false"
true=순수 연주곡, 보컬 없음. 기본값은 false입니다.
version
string
필수
생성 버전: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, 음질과 과금에 영향을 미칩니다. 두 모드 모두에서 필수이며, 전달하지 않으면 바로 400이 반환됩니다.
prompt
string
영감 프롬프트 / 가사. custom=false일 때 필수(영감 설명으로 사용됨). custom=true일 때: instrumental=false이면 필수(가사로 사용됨); instrumental=true이면 선택 사항입니다. 누락된 경우 제출 시 바로 400이 반환됩니다(업스트림 호출 없음, 과금 없음).
title
string
제목(커스텀 모드). custom=false(영감 모드)일 때는 무시됩니다.
style
string
스타일 태그(커스텀 모드, 업스트림 tags에 대응). custom=false(영감 모드)일 때는 무시됩니다.
negative_tags
string
부정 스타일 태그(원하지 않는 스타일). custom=true일 때만 적용됩니다.
auto_lyrics
boolean
true=입력한 가사를 바탕으로 2차 창작합니다. custom=true일 때만 적용됩니다.
persona_id
string
Persona 스타일 id. custom=true일 때만 적용됩니다.
vocal_gender
string
보컬 성별: Male / Female(m / f / male / female도 허용되며 백엔드에서 자동으로 정규화됩니다). 두 모드 모두에서 적용됩니다.
style_weight
number
스타일 가중치, 0.001.00. custom=true일 때만 적용됩니다.
weirdness_constraint
number
창의성, 0.001.00. custom=true일 때만 적용됩니다.
audio_weight
number
오디오 가중치, 0.001.00. 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을 가져옵니다(그 외 image_url / video_url / title / duration 등도 있음). 실패 시 data.error.message에 원인이 표시되며 선차감된 크레딧이 자동으로 환불됩니다.

Response

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