Skip to main content
POST

Authorizations

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

Body

string
기본값:"suno"
오디오 모델. 현재는 suno를 전달합니다(전달하지 않으면 기본값 suno).
array
필수
공개적으로 접근 가능한 1~4개의 오디오 URL 배열.
string
기본값:"v6"
공개 버전: v6 / v6-wild / v6-mini. 기본값은 v6이며 custom_model_id 사용 시 생략하세요.
string
모델 생성 작업이 반환한 전체 UUID. version과 함께 사용할 수 없습니다.
string
가사 / 내용.
string
제목.
string
스타일 태그.
string
제외할 스타일 태그.
number
스타일 가중치, 0.00–1.00.
number
창의성 가중치, 0.00~1.00. 이전 이름 weirdness_constraint도 지원하지만 새 요청은 weirdness를 사용하세요.
number
오디오 가중치, 0.00–1.00.
string
보컬 성별: Male / Female.
boolean
true=입력한 가사를 바탕으로 2차 창작합니다.
string
스타일 변화: off / normal / high / extra / max. 선택 사항입니다.
boolean
기본값:"false"
Max 모드를 활성화하며 일반 가격의 2배로 청구됩니다.
string
출력 오디오 형식: mp3 / m4a / wav.
이 API는 공개 접근 가능한 오디오 링크 1~4개를 받으며 custom, instrumental, gpt_description, persona_id, 목표 길이 필드는 보내지 않습니다.
결과 조회: 비동기 작업입니다. 제출 후 task_id를 받고 status가 completed 또는 failed가 될 때까지 35초마다 GET /v1/music/tasks/{task_id}를 폴링합니다. 음악 생성은 보통 30120초가 걸리며, 처리 중 status는 pending 또는 processing일 수 있고 progress는 0~100의 정수지만 일정 간격으로 변한다고 보장되지 않습니다. 완료 후 data.result.music[]에서 audio_url을 읽습니다. 실패 시 사유는 data.error.message에 있으며 차감 금액은 자동 환불됩니다.

Response

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