Skip to main content
AI를 사용하여 음악과 가사를 생성합니다. 이 API는 비동기 방식으로 동작합니다. 생성 응답은 작업 ID를 반환하며, 사용 가능할 때는 우선 사용해야 하는 poll_url 도 함께 반환할 수 있습니다.

요청 본문

string
기본값:"suno_music"
사용할 모델: 음악 생성의 경우 suno_music, 가사 전용의 경우 suno_lyrics입니다.
string
음악 설명입니다. music, lyrics, upload-cover, upload-extend 요청에는 필수이며 add-instrumental 에서는 생략할 수 있습니다.
string
생성된 곡의 제목입니다.
string
스타일 태그 (예: “pop, upbeat, electronic”).
string
피할 스타일입니다. audio_operationadd-instrumental 인 경우 필수입니다.
string
생성 유형: MUSIC (기본값) 또는 LYRICS입니다.
string
공식 Suno 모델 버전입니다. 음악 생성에는 필수입니다(action이 생략되었거나 MUSIC인 경우). 가사 전용 요청에서는 생략하세요. 지원 값: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
boolean
true 로 설정하면 보컬 없는 연주곡을 생성합니다.
string
공개적으로 접근 가능한 참조 또는 업로드 오디오 URL입니다. audio_operation 없이 제공하면 upload-cover 흐름을 사용합니다.
string
업로드 오디오 모드: upload-cover, upload-extend, add-instrumental. upload-extendcontinue_at 이 필요하고, add-instrumentalaudio_url, title, tags, negative_tags 가 필요합니다.
string
이어 나갈 이전 클립의 ID입니다.
number
이어 만들기 시작 시점(초)입니다. audio_operationupload-extend 인 경우 필수입니다.

응답

string
상태 폴링을 위한 작업 ID입니다.
string
어댑터가 반환하는 경우의 비동기 작업 ID 별칭입니다.
string
사용 가능할 때 반환되는 우선 폴링 URL입니다.
string
작업 상태: pending, processing, completed 또는 failed입니다.
integer
작업이 생성된 Unix 타임스탬프입니다.