Skip to main content
POST

인증

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

요청 파라미터

string
필수
모델 이름, "flowmusic" 고정값(대소문자 구분 없음)
string
필수
비디오를 생성할 음악의 clip_id, 성공한 작업의 result.music[].clip_id에서 가져옵니다
string
기본값:"simple"
비디오 템플릿 프리셋선택 가능한 값:
  • simple - 심플 템플릿
  • modern - 모던 스타일 템플릿
  • player - 플레이어 스타일 템플릿

응답

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

사용 시나리오

시나리오 1: modern 템플릿으로 음악 비디오 렌더링

작업 결과 조회음악 비디오 렌더링은 비동기 작업으로, 제출 후 task_id가 반환됩니다. 작업 상태 조회 API로 생성 진행 상황과 결과를 확인하세요. 결과는 result.music[0].video_url에 있습니다.

작업 완료 결과 예시

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