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

아래 텍스트 투 비디오 예제의 출력: muse-video, 10초, 16:9

API 키 만들기

토큰 관리에서 다음 설정으로 API 키(콘솔에서는 ‘토큰’이라고 부릅니다)를 추가하세요. Meta 계정이나 별도의 비디오 전용 그룹은 필요하지 않습니다.

요금

Muse 비디오는 한 편 단위로 과금합니다. 모델 안에서 고른 길이, 종횡비, 이미지 전송 여부에 따라 가격이 달라지지 않습니다. 과금 방식은 다음과 같습니다.
  • 작업을 만들 때 과금되며, 실패한 작업은 전액 환불됩니다.
  • 파라미터 오류로 제출 단계에서 거부된 요청은 과금되지 않습니다.
  • 다시 제출하면 새 작업이 만들어져 다시 과금되므로, 자체 작업 ID와 작업 id의 대응 관계를 보관하세요.
작업별 실제 청구 금액은 호출 로그에서 확인할 수 있습니다.

비디오 모델 고르기

2026년 10월 31일 기준으로, 720p 이상 10초 클립에서 LaoZhang API의 비디오 모델 중 Muse가 가장 저렴합니다. 비디오당 고정 가격이 필요하거나, 20~60초의 연속된 클립이 필요하거나, 기존 비디오를 이어 만들 때 사용하세요. 2K, 참조 비디오, 참조 오디오가 필요하면 MiniMax H3를 쓰세요. 1080p는 Seedance 또는 Wan을 쓰세요. 모델별 5초·10초 클립 비용과 엔드포인트는 비디오 API 비교에 정리되어 있습니다.

샘플 출력

아래 클립은 편집하지 않은 Muse 출력이며 모델이 만든 사운드트랙이 들어 있습니다. 클립을 눌러 재생하세요. 각 캡션에는 모델, 길이, 종횡비, 프롬프트가 있습니다. MiniMax H3 샘플 출력은 같은 프롬프트를 쓰므로 장면별로 두 모델을 비교할 수 있습니다.

muse-video, 5초, 16:9. 프롬프트: A red fox walking through snowy forest at sunrise, cinematic

muse-video-20s로 앞의 5초 클립을 20초 클립으로 이어 만든 결과. 프롬프트: The fox reaches a frozen river and looks across it as the sun rises higher

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로 앞의 20초 클립을 40초 클립으로 이어 만든 결과. 프롬프트: The paper boat sails across the pond, passes under a wooden bridge and reaches a garden fountain

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

작동 방식

1

작업 생성

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

상태 조회

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

결과 다운로드

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

환경 설정

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장 보냅니다. 모델은 이미지의 피사체와 스타일을 비디오에 반영하며, 어느 이미지도 첫 프레임으로 쓰지 않습니다.

이미지와 종횡비

첫 프레임, 마지막 프레임, 참조 이미지를 보낼 때 클립의 비율은 다음과 같이 정해집니다.
  • aspect_ratio(또는 size)를 보낸 경우: 생성 전에 각 이미지를 해당 비율로 중앙 크롭하고, 클립도 그 비율로 나옵니다. 크기는 아래 요청 필드 절에 있습니다.
  • 보내지 않은 경우: 클립이 이미지 자체의 비율을 따릅니다. 3:2 가로 사진이면 1152×768이 됩니다.
중앙 크롭은 이미지의 좌우 또는 위아래를 잘라 냅니다. 피사체가 가장자리에 있다면 업로드하기 전에 목표 비율로 직접 잘라서 구도를 정하세요.

20초, 30초, 최대 60초 클립 만들기와 비디오 이어 만들기

긴 모델은 각각 이름에 적힌 길이(20~60초)의 연속된 클립 하나를 만듭니다. 가격은 위 요금 절에 있습니다. 호출 방법은 muse-video와 같고 seconds는 생략할 수 있습니다. 기존 클립에서 이어 만들려면 video_url을 보냅니다.
이어 만들기 규칙은 다음과 같습니다.
  • muse-video를 제외한 모든 모델이 video_url을 받습니다. 완성된 비디오의 길이는 원본 클립을 포함해 모델 이름에 적힌 길이입니다.
  • 원본은 공개적으로 내려받을 수 있는 https MP4 링크여야 하고, 완성 길이보다 2초 이상 짧아야 합니다. muse-video-20s는 18초까지, muse-video-30s는 28초까지이며, muse-video-60s는 58초까지입니다.
  • 원본 파일이 약 19MB보다 크면 LaoZhang API가 먼저 720p로 압축하므로 결과에서 원본 부분이 조금 더 부드럽게 보입니다.
  • 예를 들어 5초 원본을 muse-video-20s로 이어 만들면 약 15초가 추가되어 20초 비디오가 됩니다.
  • LaoZhang API가 반환한 video_url도 원본으로 쓸 수 있습니다.

조회와 다운로드

작업 조회

비디오를 렌더링하는 동안 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으로 반환됩니다. 작업이 만들어지지 않고 과금도 되지 않습니다. 나머지는 실패한 작업으로 도착하며 이미 환불되었습니다.

자주 묻는 질문

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를 추가하면 이미지를 먼저 그 비율로 중앙 크롭하므로 원하는 비율로 클립이 나옵니다. 피사체가 이미지 가장자리에 있다면 업로드하기 전에 직접 잘라 주세요. 위의 이미지와 종횡비 절을 참고하세요.

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

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

타임아웃이나 실패 뒤에 다시 제출해도 되나요?

먼저 작업을 확인하세요. 클라이언트 쪽 타임아웃이 작업 실패를 뜻하지는 않으므로 같은 id로 계속 조회하세요. 다시 제출하면 새 작업이 만들어져 다시 과금됩니다. status가 failed일 때만 요청을 고쳐 새 작업을 만드세요. 실패한 작업은 이미 환불되었고, 40분이 지나도 끝나지 않은 작업은 실패로 처리되어 자동으로 환불됩니다.

비디오 링크는 얼마나 보관되나요?

7일입니다. 이후에는 링크가 만료되어 작업을 다시 내려받을 수 없으니 작업이 완료되면 파일을 저장하세요.

관련 문서