메인 콘텐츠로 건너뛰기
Muse는 Meta의 비디오 생성 모델입니다. 모든 클립에 음악과 효과음이 들어가며, 요청 한 번으로 최대 60초의 연속된 클립을 받을 수 있습니다. LaoZhang API는 비디오당 과금하며 5~10초는 $0.30, 60초는 $1.55이고, 표준 토큰 그룹이면 모두 호출할 수 있습니다.
Muse 텍스트 투 비디오 샘플: 새벽 바위 해안의 등대와 바위에 부서지는 파도

아래 텍스트 투 비디오 예제의 출력: 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 키(콘솔에서는 ‘토큰’이라고 부릅니다)를 추가하세요. Meta 계정이나 별도의 비디오 전용 그룹은 필요하지 않습니다.

작동 방식

1

작업 생성

최소한 model과 prompt를 넣어 POST /v1/videos를 호출합니다. 이 엔드포인트는 비동기라서 비디오가 완성되기를 기다리지 않고 몇 초 안에 작업 id를 반환합니다. 이 값을 저장하세요.
2

상태 조회

15초마다 GET /v1/videos/{id}를 호출해 status를 읽습니다. 호출은 바로 응답합니다. 10초 이하 클립은 보통 23분 안에 끝나며 혼잡할 때는 5분이 넘기도 합니다. 2030초 클립은 약 410분, 4060초 클립은 약 5~10분 걸립니다. 혼잡할 때는 60초 클립이 20분 가까이 걸리기도 합니다.
3

결과 다운로드

status가 completed가 되면 video_url에서 MP4를 내려받습니다. 다운로드에는 Authorization 헤더가 필요 없습니다.
최대 30분 동안 계속 조회하고, 작업이 진행 중일 때는 다시 제출하지 마세요.
  • 제출과 조회 모두 바로 응답하므로 HTTP 타임아웃을 길게 잡을 필요가 없습니다.
  • 30분은 조회 제한 시간입니다. status가 queued 또는 in_progress인 동안은 계속 확인하세요.
  • 조회를 멈췄다면 나중에 같은 id로 다시 확인하세요. 다시 제출하면 새 작업이 만들어져 다시 과금됩니다.
  • 60분이 지나도 끝나지 않은 작업은 실패로 처리되며 전액 환불됩니다.

환경 설정

cURL 예제는 응답에서 필드를 읽기 위해 jq를 사용합니다(macOS에서는 brew install jq). 먼저 키와 base URL을 설정하세요.

비디오 만들기

텍스트로 비디오 만들기

아래 요청의 프롬프트는 위 샘플 이미지를 만든 영어 프롬프트 그대로입니다.
요청이 성공하면 대기 중인 작업이 반환됩니다.
자주 쓰는 선택 필드는 두 가지입니다.
  • seconds: 생략하면 muse-video는 10초 클립을 만듭니다.
  • aspect_ratio: 클립의 비율입니다. 720x1280처럼 픽셀 단위 size를 대신 보낼 수도 있습니다. 첫 프레임이나 참조 이미지를 보낼 때도 적용되며, 자세한 내용은 아래 이미지와 종횡비 절에 있습니다.

첫 프레임 또는 첫·마지막 프레임으로 움직이기

image로 시작 장면을 지정하고, last_frame을 더하면 끝 장면도 지정할 수 있습니다. 각 이미지는 공개 URL 또는 data:image/...;base64, 데이터 URL이어야 합니다.
모델은 두 이미지를 시각적 참조로 사용합니다. 클립은 같은 구도로 시작하고 끝나지만 세부 요소가 픽셀 단위로 똑같이 재현되지는 않습니다. 로컬 파일을 올리려면 multipart 폼 데이터를 보냅니다. 첫 프레임은 input_reference에, 마지막 프레임은 last_frame에 넣습니다.
-F로 업로드할 때는 Content-Type: application/json을 설정하지 마세요. 이미지는 한 장당 최대 10MB입니다.

참조 이미지로 만들기

reference_images에 이미지를 1~4장 보냅니다. 모델은 이미지의 피사체와 스타일을 비디오에 반영하며, 어느 이미지도 첫 프레임으로 쓰지 않습니다.
참조 이미지가 주로 정하는 것은 인물의 옷차림, 헤어스타일, 전체 스타일, 장면 요소입니다. 같은 얼굴이 나온다는 보장은 없습니다. 보내는 방식을 바꿔도 같은 얼굴은 유지되지 않습니다. 원본 이미지, 중앙 크롭, 흰 여백을 더한 이미지, 얼굴 클로즈업 중 무엇을 보내도 클립의 옷차림과 헤어스타일은 참조 이미지를 따르지만 이목구비는 따르지 않습니다. 여러 클립에서 같은 얼굴이 필요하다면 비디오 생성 API 비교와 가격에서 다른 모델과 비교해 보세요. 참조 이미지와 프롬프트가 서로 다르면 프롬프트를 따릅니다. 예를 들어 참조 이미지가 야경인데 프롬프트에 “오후의 자연광”이라고 쓰면 낮 장면이 나옵니다. 참조 이미지의 빛과 시간대를 살리려면 프롬프트에 반대되는 묘사를 넣지 마세요.

이미지와 종횡비

첫 프레임, 마지막 프레임, 참조 이미지를 보낼 때 클립의 비율은 다음과 같이 정해집니다.
  • 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 없이 같은 과정을 직접 진행할 수도 있습니다.
  1. 앞 구간의 마지막 프레임을 추출합니다.
  2. last-frame.jpg를 첫 프레임(image, multipart에서는 input_reference)으로 보내 다음 구간을 만듭니다. 요청 방법은 위의 ‘첫 프레임 또는 첫·마지막 프레임으로 움직이기’ 절과 같습니다.
  3. 두 구간을 합칩니다. 이미지를 보내면 출력 크기가 수십 픽셀 다를 수 있으므로 새 구간을 첫 구간 크기로 맞춥니다. 아래 명령의 1280×720은 실제 크기로 바꾸세요.
이음매는 다음과 같이 보입니다.
  • 각 구간이 앞 구간의 마지막 프레임에서 시작하므로 이음매마다 화면이 이어집니다.
  • 움직임과 음악은 구간마다 새로 시작합니다. 더 자연스럽게 이으려면 프롬프트마다 그다음에 일어날 일을 적고, 모든 구간에서 같은 종횡비와 화풍 설정을 유지하세요.

화풍과 카메라 워크 지정하기

Muse에는 내장 화풍 7가지와 카메라 워크·전환 기법 13가지가 있어 ID로 고를 수 있고, 화풍과 카메라 움직임을 직접 글로 적을 수도 있습니다. 모든 Muse 모델에서 쓸 수 있으며 추가 요금은 없습니다. custom_style과 custom_skill은 단독으로 써도 되고 내장 ID와 함께 써도 됩니다. 아래 요청은 애니메이션 화풍에 카메라 움직임을 글로 덧붙인 예입니다.

위 요청의 출력: muse-video, 10초, 16:9, style_preset 2d_anime와 custom_skill

사용할 수 있는 ID입니다. 이 필드를 생략하면 이렇게 동작합니다.
  • 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 레퍼런스

요청 필드

종횡비별 출력 크기입니다. 이미지를 보내면 같은 비율에서도 크기가 표와 수십 픽셀 다를 수 있습니다. 예를 들어 16:9는 1248×704, 4:3은 1056×800이 되기도 합니다. 프레임 레이트는 항상 24fps이며 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를 보내면 참조 이미지를 먼저 중앙 크롭하므로 가장자리에 있는 인물이 잘릴 수 있습니다. 업로드하기 전에 모든 인물이 화면 안에 들어오도록 목표 비율로 직접 잘라 두세요.
같은 얼굴이 필요하다면 비디오 생성 API 비교와 가격에서 다른 모델과 비교해 보세요. 자세한 내용은 위의 참조 이미지로 만들기 절을 참고하세요.

비디오에 소리가 들어가나요? 끌 수 있나요?

모든 클립에 프롬프트에 맞춘 음악과 효과음이 들어갑니다. 끄는 옵션은 없으므로, 소리가 필요 없다면 다운로드한 뒤 오디오 트랙을 제거하세요.

긴 클립의 이음매에 전환 효과가 들어가나요?

기본으로는 전환 효과가 들어가지 않습니다. 다만 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일입니다. 이후에는 링크가 만료되어 작업을 다시 내려받을 수 없으니 작업이 완료되면 파일을 저장하세요.

관련 문서