
아래 텍스트 투 비디오 예제의 출력: muse-video, 10초, 16:9
요금과 모델 선택
요금
Muse 비디오는 한 편 단위로 과금합니다. 모델 안에서 고른 길이, 종횡비, 이미지 전송 여부에 따라 가격이 달라지지 않습니다.- 작업을 만들 때 과금되며, 실패한 작업은 전액 환불됩니다.
- 파라미터 오류로 제출 단계에서 거부된 요청은 과금되지 않습니다.
- 다시 제출하면 새 작업이 만들어져 다시 과금되므로, 자체 작업 ID와 작업
id의 대응 관계를 보관하세요.
비디오 모델 고르기
2026년 10월 31일 기준으로, 720p 이상 10초 클립에서 LaoZhang API의 비디오 모델 중 Muse가 가장 저렴합니다. 비디오당 고정 가격이 필요하거나 20~60초의 연속된 클립이 필요할 때 사용하세요. 2K, 참조 비디오, 참조 오디오가 필요하면 MiniMax H3를 쓰세요. 1080p가 필요하거나 인물이 대사를 말해야 하면 Gemini Omni 1.2 Flash를 쓰세요. 모델별 5초·10초 클립 비용과 엔드포인트는 비디오 API 비교에 정리되어 있습니다.샘플 출력
아래 클립은 편집하지 않은 Muse 출력이며 모델이 만든 사운드트랙이 들어 있습니다. 클립을 눌러 재생하세요. 각 캡션에는 모델, 길이, 종횡비, 프롬프트가 있습니다. MiniMax H3 샘플 출력은 같은 프롬프트를 쓰므로 장면별로 두 모델을 비교할 수 있습니다.muse-video, 5초, 16:9. 프롬프트: A red fox walking through snowy forest at sunrise, cinematic
muse-video-20s, 20초, 16:9. 프롬프트: A paper boat drifts down a rainy city gutter, then sails into a small sunny pond
muse-video-40s, 40초, 16:9. 프롬프트: A hot air balloon rises over a valley at dawn, drifts over a river and a village, then lands in a meadow
muse-video-50s, 50초, 9:16 세로. 프롬프트: A cyclist rides through a coastal town from morning to sunset: market, harbor, cliff road, lighthouse
시작하기 전에
API 키 만들기
토큰 관리에서 다음 설정으로 API 키(콘솔에서는 ‘토큰’이라고 부릅니다)를 추가하세요.작동 방식
작업 생성
model과 prompt를 넣어 POST /v1/videos를 호출합니다. 이 엔드포인트는 비동기라서 비디오가 완성되기를 기다리지 않고 몇 초 안에 작업 id를 반환합니다. 이 값을 저장하세요.상태 조회
GET /v1/videos/{id}를 호출해 status를 읽습니다. 호출은 바로 응답합니다. 10초 이하 클립은 보통 2결과 다운로드
status가 completed가 되면 video_url에서 MP4를 내려받습니다. 다운로드에는 Authorization 헤더가 필요 없습니다.환경 설정
cURL 예제는 응답에서 필드를 읽기 위해jq를 사용합니다(macOS에서는 brew install jq). 먼저 키와 base URL을 설정하세요.
비디오 만들기
텍스트로 비디오 만들기
아래 요청의 프롬프트는 위 샘플 이미지를 만든 영어 프롬프트 그대로입니다.seconds: 생략하면muse-video는 10초 클립을 만듭니다.aspect_ratio: 클립의 비율입니다.720x1280처럼 픽셀 단위size를 대신 보낼 수도 있습니다. 첫 프레임이나 참조 이미지를 보낼 때도 적용되며, 자세한 내용은 아래 이미지와 종횡비 절에 있습니다.
첫 프레임 또는 첫·마지막 프레임으로 움직이기
image로 시작 장면을 지정하고, last_frame을 더하면 끝 장면도 지정할 수 있습니다. 각 이미지는 공개 URL 또는 data:image/...;base64, 데이터 URL이어야 합니다.
input_reference에, 마지막 프레임은 last_frame에 넣습니다.
-F로 업로드할 때는 Content-Type: application/json을 설정하지 마세요. 이미지는 한 장당 최대 10MB입니다.
참조 이미지로 만들기
reference_images에 이미지를 1~4장 보냅니다. 모델은 이미지의 피사체와 스타일을 비디오에 반영하며, 어느 이미지도 첫 프레임으로 쓰지 않습니다.
이미지와 종횡비
첫 프레임, 마지막 프레임, 참조 이미지를 보낼 때 클립의 비율은 다음과 같이 정해집니다.aspect_ratio(또는size)를 보낸 경우: 생성 전에 각 이미지를 해당 비율로 중앙 크롭하고, 클립도 그 비율로 나옵니다. 크기는 아래 요청 필드 절에 있습니다.- 보내지 않은 경우: 클립이 이미지 자체의 비율을 따릅니다. 3:2 가로 사진이면 1152×768이 됩니다.
20초, 30초, 최대 60초 클립 만들기
긴 모델은 각각 이름에 적힌 길이(20~60초)의 연속된 클립 하나를 만듭니다. 가격은 위 요금 절에 있습니다. 호출 방법은muse-video와 같고 seconds는 생략할 수 있습니다.
긴 클립은 10초씩 생성한 뒤 이어 붙이므로, 이음매마다 움직임이 느려졌다가 다시 시작되어 잠깐 멈춘 것처럼 보일 수 있습니다. 끊김 없이 흘러가야 하는 장면은 muse-video로 10초 이하 클립 하나를 만드세요. 더 긴 클립은 아래 자주 묻는 질문의 ‘긴 클립의 이음매에 전환 효과가 들어가나요?‘를 참고하세요.
60초보다 긴 비디오를 만들거나 이미 있는 클립에서 이어 가려면 아래 ‘60초보다 긴 비디오 만들기’ 절을 참고하세요.
60초보다 긴 비디오 만들기
작업 하나로 만들 수 있는 길이는 최대 60초입니다. 더 긴 비디오는 구간으로 나눠 만듭니다. 각 구간은 앞 구간의 마지막 프레임에서 시작하고, 마지막에 모든 구간을 하나로 합칩니다. 기존 비디오에서 이어 가려면 그 비디오를 첫 구간으로 삼으세요. 아래 스크립트는 구간을 순서대로 만든 뒤 하나로 합칩니다.requests와 ffmpeg가 필요합니다. PROMPTS에 구간마다 프롬프트를 하나씩 넣고, 기존 비디오에서 이어 가려면 START_VIDEO에 그 파일의 로컬 경로를 지정하세요.
muse-video-60s 구간 세 개를 만들면 약 3분 길이의 비디오가 되며 비용은 3 × $1.55 = $4.65입니다. 각 구간은 일반 작업이라 해당 모델의 가격으로 과금됩니다. 한 구간이 실패하면 그 구간만 환불되고 이미 내려받은 구간은 그대로 남으므로, 실패한 구간부터 다시 이어 가면 됩니다.
Python 없이 같은 과정을 직접 진행할 수도 있습니다.
-
앞 구간의 마지막 프레임을 추출합니다.
-
last-frame.jpg를 첫 프레임(image, multipart에서는input_reference)으로 보내 다음 구간을 만듭니다. 요청 방법은 위의 ‘첫 프레임 또는 첫·마지막 프레임으로 움직이기’ 절과 같습니다. -
두 구간을 합칩니다. 이미지를 보내면 출력 크기가 수십 픽셀 다를 수 있으므로 새 구간을 첫 구간 크기로 맞춥니다. 아래 명령의 1280×720은 실제 크기로 바꾸세요.
- 각 구간이 앞 구간의 마지막 프레임에서 시작하므로 이음매마다 화면이 이어집니다.
- 움직임과 음악은 구간마다 새로 시작합니다. 더 자연스럽게 이으려면 프롬프트마다 그다음에 일어날 일을 적고, 모든 구간에서 같은 종횡비와 화풍 설정을 유지하세요.
화풍과 카메라 워크 지정하기
Muse에는 내장 화풍 7가지와 카메라 워크·전환 기법 13가지가 있어 ID로 고를 수 있고, 화풍과 카메라 움직임을 직접 글로 적을 수도 있습니다. 모든 Muse 모델에서 쓸 수 있으며 추가 요금은 없습니다.custom_style과 custom_skill은 단독으로 써도 되고 내장 ID와 함께 써도 됩니다. 아래 요청은 애니메이션 화풍에 카메라 움직임을 글로 덧붙인 예입니다.
위 요청의 출력: muse-video, 10초, 16:9, style_preset 2d_anime와 custom_skill
style_preset을 생략하면 내장 화풍이 더해지지 않고 프롬프트와 이미지가 화풍을 정합니다.none도 같습니다.skill_preset을 생략하면 내장 전환이 더해지지 않고 긴 클립의 구간이 그대로 이어집니다. 다만 이음매마다 움직임이 느려졌다가 다시 시작될 수 있습니다.none도 같습니다.occlusion_wipe를 쓰면 이음매마다 전경 물체가 화면을 가려 1~2초 정도 어두워지므로, 장면을 분명히 끊고 싶을 때만 쓰세요.none은 다른 기법과 함께 지정할 수 없습니다.- 기존
style필드도 화풍을 자유롭게 적는 힌트로 계속 쓸 수 있습니다.
조회와 다운로드
작업 조회
status는 in_progress이고 progress에 대략적인 진행률이 표시됩니다.
video_url이 포함됩니다.
status: "failed"이고 사유가 error.message에 있습니다. 청구 금액은 이미 환불되었습니다.
비디오 다운로드
Authorization 헤더와 함께 GET /v1/videos/{id}/content를 호출해도 MP4 파일이 반환됩니다.
최소 Python 클라이언트
requests가 필요합니다(pip install requests).
API 레퍼런스
요청 필드
resolution과 fps는 출력을 바꾸지 않습니다.
작업 상태
오류
- 처음 여섯 가지는 제출 시점에 HTTP 400으로 반환되며 작업이 만들어지지 않습니다.
Task protocol request failed와Current group … has no available channels …도 제출 시점에 반환되며 작업이 만들어지지 않습니다.- 나머지는 실패한 작업으로 도착해 자동으로 환불되거나, 메시지에
This request is not charged.가 적혀 있습니다.
자주 묻는 질문
5초 클립과 10초 클립의 가격이 같나요?
같습니다.muse-video는 5, 8, 10초 모두 $0.30입니다. 더 긴 연속 장면에는 muse-video-20s($0.55), muse-video-30s($0.80)부터 muse-video-60s($1.55)까지 쓰세요.
1080p 비디오를 받을 수 있나요?
받을 수 없습니다. Muse는 가로 1280×720, 세로 720×1280으로 출력하며 다른 비율은 요청 필드 절에 있습니다.resolution: "1080p"를 보내도 요청은 받아들여지지만 출력 크기는 바뀌지 않습니다.
클립이 참조 이미지나 첫 프레임의 비율을 따르는 이유는 무엇인가요?
aspect_ratio나 size를 보내지 않으면 Muse는 보낸 이미지의 비율을 유지합니다. aspect_ratio를 추가하면 이미지를 먼저 그 비율로 중앙 크롭하므로 원하는 비율로 클립이 나옵니다. 잘려 나간 부분에 있던 인물은 클립에 나오지 않을 수 있습니다. 피사체가 이미지 가장자리에 있다면 업로드하기 전에 직접 잘라 주세요. 위의 이미지와 종횡비 절을 참고하세요.
클립 속 인물의 얼굴이 참조 이미지와 다른 이유는 무엇인가요?
Muse는 참조 이미지 속 인물의 옷차림, 헤어스타일, 전체 스타일을 이어받지만 같은 얼굴이 나오거나 모든 인물이 등장한다는 보장은 없습니다. 여러 사람이 나오는 장면에서는 참조 이미지에 없는 인물이 더해지기도 합니다. 원본 이미지, 여백을 더한 이미지, 얼굴 클로즈업 중 무엇을 보내도 결과는 같았습니다.- 프롬프트에 인물마다 외모와 위치를 적고, 장면에는 이 인물들만 나온다고 밝히세요.
aspect_ratio를 보내면 참조 이미지를 먼저 중앙 크롭하므로 가장자리에 있는 인물이 잘릴 수 있습니다. 업로드하기 전에 모든 인물이 화면 안에 들어오도록 목표 비율로 직접 잘라 두세요.
비디오에 소리가 들어가나요? 끌 수 있나요?
모든 클립에 프롬프트에 맞춘 음악과 효과음이 들어갑니다. 끄는 옵션은 없으므로, 소리가 필요 없다면 다운로드한 뒤 오디오 트랙을 제거하세요.긴 클립의 이음매에 전환 효과가 들어가나요?
기본으로는 전환 효과가 들어가지 않습니다. 다만 20~60초 클립은 10초짜리 구간을 이어 붙여 만듭니다. 이음매(10초, 20초, 30초 …)마다 앞 구간 끝의 움직임이 느려지고 다음 구간이 다시 움직이기 시작해서 잠깐 멈춘 것처럼 보일 수 있습니다. 네트워크나 인코딩과는 관계가 없습니다.- 끊김 없이 흘러가야 하는 장면:
muse-video로 10초 이하 클립 하나를 만드세요. 이음매가 없습니다. - 20초 이상: 프롬프트에 이음매를 컷으로 적으세요. 예를 들어 “10초에 상대 인물의 클로즈업으로 컷”처럼 씁니다. 또는
skill_preset: "cut_on_action"이나"whip_pan"을 보내 이음매를 자연스러운 편집점으로 만드세요. ID는 위의 화풍과 카메라 워크 절에 있습니다.
중국어 대사의 발음이 어색한 이유는 무엇인가요?
Muse는 프롬프트에 적은 중국어 대사를 인물이 말하게 할 수 있지만 중국어 발음이 정확하지 않습니다. 몇몇 단어는 매번 틀리게 발음되며, 이는 모델의 한계입니다. 중국어 대사가 중요하다면 다음 방법을 쓰세요.- Gemini Omni 1.2 Flash를 쓰세요. 같은
/v1/videos엔드포인트로 호출하며, 프롬프트의 중국어 대사를 정확하게 말하고 720p 3~10초 클립 하나가 $0.30입니다. - 또는 Muse를 그대로 쓰되 프롬프트에는 동작과 입 모양만 적고, 음성은 직접 더빙하세요.
60초보다 긴 비디오를 만들 수 있나요?
만들 수 있습니다. 작업 하나는 최대 60초이므로 앞 구간의 마지막 프레임에서 시작하는 구간을 여러 개 만든 뒤 합치세요.muse-video-60s 구간 세 개면 약 3분 길이의 비디오를 $4.65에 만들 수 있습니다. 스크립트와 직접 하는 방법은 위의 ‘60초보다 긴 비디오 만들기’ 절에 있습니다.
이미 있는 비디오를 더 길게 이어 갈 수 있나요?
있습니다. 그 비디오를 첫 구간으로 삼아 마지막 프레임을 다음 구간의 첫 프레임으로 보내고, 두 구간을 합치세요. 각 구간은 해당 모델의 가격으로 과금됩니다. 스크립트와 직접 하는 방법은 위의 ‘60초보다 긴 비디오 만들기’ 절에 있습니다.타임아웃이나 실패 뒤에 다시 제출해도 되나요?
먼저 작업을 확인하세요. 클라이언트 쪽 타임아웃이 작업 실패를 뜻하지는 않으므로 같은id로 계속 조회하세요. 다시 제출하면 새 작업이 만들어져 다시 과금됩니다. status가 failed일 때만 요청을 고쳐 새 작업을 만드세요. 실패한 작업은 이미 환불되었고, 60분이 지나도 끝나지 않은 작업은 실패로 처리되어 자동으로 환불됩니다.
비디오 링크는 얼마나 보관되나요?
7일입니다. 이후에는 링크가 만료되어 작업을 다시 내려받을 수 없으니 작업이 완료되면 파일을 저장하세요.관련 문서
- 비디오 생성 API 비교와 가격
- MiniMax H3 비디오 API
- Seedance 2.0 비디오 API
- Wan 2.7·Wan 3.0 비디오 API
- 모델 및 가격
- 호출 로그
- Meta Model API 모델: Muse Spark, Muse Image 등이 있으며 비디오 생성 모델은 없습니다(2026년 10월 30일 확인)