Skip to main content
POST

인증

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

요청 파라미터

string
필수
모델 이름, "flowmusic" 고정값(대소문자 구분 없음)
string
필수
모델 버전, "lyria-3.5" 고정값
Lyria 3.5도 모델 이름으로 flowmusic을 사용합니다. modellyria-3.5 또는 flowmusic-lyria-3.5로 변경하지 마세요.
string
음악 스타일 또는 사운드 설명 프롬프트예시: "upbeat pop music with piano"
sound_promptlyrics동시에 비어 있을 수 없습니다(최소 하나는 전달). 요청당 한 곡의 음악만 생성됩니다.
string
가사 텍스트. 먼저 가사 생성 API로 가사를 생성한 후 이 필드에 넣을 수 있습니다예시: "[Verse 1]\n밤이 아무리 길어도 아침은 온다\n..."
string
생성할 음악 제목
string
BPM(분당 박자 수), 반드시 ≥ 1예시: "120"
integer
생성 길이(초)지원 범위: 1 ~ 240
string
결과 재현에 사용하는 랜덤 시드
동일한 요청에 동일한 seed 값을 전달하면 유사한 결과가 생성되지만, 완전히 동일함을 보장하지는 않습니다.

응답

integer
응답 상태 코드, 성공 시 200
array
반환 데이터 배열

사용 시나리오

시나리오 1: 스타일 프롬프트만으로 생성

시나리오 2: 가사 + 스타일로 곡 만들기

작업 결과 조회음악 생성은 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 조회 API로 생성 진행 상황과 결과를 확인하세요.

작업 완료 결과 예시

조회 응답 예시(GET /v1/music/tasks/{task_id}):