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
필수
원본 음악 clip_id, 성공한 작업의 result.music[].clip_id에서 가져옵니다
number
필수
교체 시작 시간(초)
number
필수
교체 종료 시간(초)
end_sstart_s보다 커야 하며, 원본 clip 길이를 초과할 수 없습니다.
string
필수
교체 구간에 대한 편집 지시예시: "피아노 버전으로 교체"
string
교체 후 음악 제목
integer
결과 재현 또는 생성 결과 제어에 사용하는 랜덤 시드

응답

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

사용 시나리오

시나리오 1: 10-20초 구간을 피아노 버전으로 교체

작업 결과 조회구간 교체는 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 조회 API로 생성 진행 상황과 결과를 확인하세요. 교체 결과물은 새로운 clip_id입니다(곡 전체가 다시 출력되며, 지정한 구간이 교체됨). 이후 작업에는 새 clip_id를 사용하세요.

작업 완료 결과 예시

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