메인 콘텐츠로 건너뛰기
POST

Authorizations

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

Body

model
string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
audio_urls
array
필수
공개적으로 접근 가능한 1~4개의 오디오 URL 배열.
version
string
기본값:"v5.5"
생성 버전: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, 음질과 과금에 영향을 미칩니다; 전달하지 않으면 기본값 v5.5입니다.
prompt
string
가사 / 내용.
title
string
제목.
tags
string
스타일 태그.
negative_tags
string
제외할 스타일 태그.
style_weight
number
스타일 가중치, 0.001.00.
weirdness_constraint
number
창의성 가중치, 0.001.00(별칭 weirdness).
audio_weight
number
오디오 가중치, 0.001.00.
vocal_gender
string
보컬 성별: Male / Female.
auto_lyrics
boolean
true=입력한 가사를 바탕으로 2차 창작합니다.
결과 가져오기: 본 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
반환 데이터 배열