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
필수
원본 음악의 고유 식별자, 성공한 작업의 result.music[].clip_id에서 가져옵니다
string
필수
Cover 편집 지시예시: "이 곡을 재즈 스타일로 편곡"
number
필수
편집 강도값 범위: 0 ~ 1, 클수록 변화가 커집니다
string
Cover 후 음악 제목
string
결과 재현에 사용하는 랜덤 시드

응답

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

사용 시나리오

시나리오 1: 곡 전체를 재즈 스타일로 편곡

시나리오 2: 외부 오디오를 가져와 편곡

먼저 오디오 업로드로 외부 오디오를 가져와 clip_id를 발급받은 후 Cover를 수행합니다:
작업 결과 조회Cover 편곡은 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 조회 API로 생성 진행 상황과 결과를 확인하세요. Cover 결과물은 새로운 clip_id이며, 이후 작업에는 새 clip_id를 사용하세요.

작업 완료 결과 예시

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