Muse Video API: 공식 API 없이 코드로 영상 생성하는 법과 편당 비용

Meta의 Muse Video에는 2026년 11월 2일 기준 공식 API가 없습니다. Meta는 7월 7일 Muse Video를 미리보기로 공개하면서 creators와 Meta AI에 "곧(coming soon)" 제공한다고만 밝혔고, 개발자용 Meta Model API의 모델 목록에도 영상을 출력하는 모델은 없습니다. 지금 Muse로 영상을 만드는 곳은 Muse 앱뿐인데, 이 앱은 미국·캐나다·일본·싱가포르에서만 열려 있어 한국에서는 앱으로 직접 만들 수도 없습니다.

그래서 자기 앱이나 n8n 같은 자동화 파이프라인에 Muse 영상을 붙이려면 비공식 경로를 골라야 합니다. 한국에서 Meta 계정 없이 바로 쓸 수 있는 것은 LaoZhang API의 muse-video 모델로, POST /v1/videos로 작업을 만들고 15초마다 상태를 조회한 뒤 MP4를 받으며 5·8·10초 영상 모두 편당 $0.30입니다. 미국·캐나다·일본·싱가포르에서 만든 Muse 계정이 이미 있다면, 그 계정을 대신 조작해 주는 useapi.net(월 $15)도 선택지가 됩니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

다만 Muse 출력은 어느 경로든 720p 등급(16:9 기준 1280×720)에 고정되고, LaoZhang API의 muse-video는 참조 영상이나 참조 오디오도 받지 않습니다. 1080p 납품이 조건이면 Seedance나 Wan, 2K나 참조 영상이 필요하면 MiniMax H3로 가는 편이 맞습니다.

Meta Model API의 Muse 모델은 텍스트·이미지만 출력합니다

"Muse API"라고 하면 Meta Model API를 떠올리기 쉽지만, 2026년 11월 2일 기준 Meta Model API 모델 문서에 올라 있는 Muse Wonder와 Muse Spark는 텍스트, Muse Image는 이미지, Muse Voice Transcribe는 텍스트를 출력합니다. 영상은 Muse Spark·Wonder가 영상을 읽고 이해하는 입력(Video understanding)으로만 등장하므로, 영상 이해 문서를 보고 영상 생성이 된다고 판단하면 안 됩니다. Muse라는 이름은 Meta의 개인 AI 에이전트 앱(muse.ai)과 이 모델군을 함께 가리키는데, 영상을 만드는 쪽은 앱입니다.

Muse Video 자체는 Meta Superintelligence Labs가 2026년 7월 7일 Muse Image·Muse Video 발표 글에서 미리보기로 공개한 모델입니다. Meta는 네이티브 오디오 지원을 강점으로, 오디오와 영상의 동기화와 물리적으로 정확한 빠른 동작을 아직 부족한 부분으로 꼽았고, 7월 5일 기준 Arena 텍스트→영상 부문 인간 선호 Elo 3위라고 밝혔습니다. 제공 시점은 "coming soon"이라는 표현뿐이고 날짜가 없으므로, 공식 API가 나오는 시점을 일정에 넣을 수는 없습니다.

한국에서 Muse 앱으로 영상을 만들 수 있나: 지원 국가는 4곳

2026년 11월 2일 기준 한국에서는 Muse 앱을 쓸 수 없습니다. Muse 앱은 미국(2026년 9월 8일), 캐나다(9월 18일), 일본(10월 23일), 싱가포르(10월 27일) 순으로 출시됐고 한국 출시 발표는 없습니다. Meta는 국가 목록을 한 페이지로 공개하지 않고 도움말에서 Muse가 아직 모든 지역에서 제공되지는 않는다고만 안내하며, 날짜의 근거는 Meta의 Muse 싱가포르 출시 발표와 AI Agents Library의 국가별 정리(10월 31일 기준)입니다.

지원 국가에서 앱은 대부분 무료로 쓸 수 있고, 유료 플랜은 Power(월 $20, 주 5억 Muse 토큰)와 Maximum(월 $100, 주 30억 Muse 토큰)입니다. 2026년 10월 22일 기준 Meta의 Muse 구독 도움말은 영상 1편이 토큰을 얼마나 쓰는지도, 무료 플랜 한도도 밝히지 않습니다. 무료로 Muse 영상을 만드는 방법은 지원 국가에서 앱의 무료 플랜을 쓰는 것뿐이고 무료 Muse 영상 API는 없으니, 돈을 들이지 않고 시험할 수 있는 영상 API는 무료 AI 영상 생성 API: 진짜 무료 경로와 가장 싼 시험 비용에서 찾는 편이 빠릅니다.

코드로 Muse 영상을 만드는 경로 비교: LaoZhang API·useapi.net·웹 생성기

코드에서 Muse 영상을 부를 수 있는 경로는 편당 결제하는 LaoZhang API와, 자기 Muse 계정을 대신 로그인해 조작하는 useapi.net 두 가지입니다. musevideos.io나 musevideo.ai 같은 "Muse Video" 웹 생성기는 크레딧을 사서 브라우저에서 만드는 서비스이고 Meta가 운영하는 곳이 아니며, musevideo.ai는 스스로를 "Meta Muse Video-style"이라고 소개합니다. 코드 경로 두 가지 중 무엇을 쓸지는 지원 국가에서 만든 Muse 계정이 있는지, 그리고 영상 길이와 비율을 코드에서 정해야 하는지에서 갈립니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

useapi.net은 Meta가 제공하지 않는 방식으로 소비자 계정을 대신 로그인시켜 쓰는 제3자 서비스라서, 계정 비밀번호를 맡기는 부담과 Muse 이용 한도를 함께 떠안습니다. useapi.net의 Muse API 문서에 따르면 자체 테스트에서 영상 1편이 60~140초 걸렸고 무료 플랜에서는 1편이 주간 한도의 2~3%를 썼으므로, 단순히 나누면 주 33~50편 정도입니다. 24시간 영상 한도에 걸린 계정은 1시간 동안 영상 작업에서 빠진다고도 안내합니다.

한국에 살면서 지원 국가에서 만든 Muse 계정이 없다면 선택지는 LaoZhang API 하나로 좁혀집니다. 계정이 있다면 비용으로 비교할 수 있는데, useapi.net 월 $15는 muse-video 50편 값이라 한 달 50편을 넘게 만들 때부터 월정액이 유리해지지만, 무료 플랜으로는 위 계산상 주 33~50편이 한계이고 길이와 비율도 고를 수 없습니다. 1080p·2K·참조 영상이 납품 조건이라면 Muse를 고집할 이유가 없으니 Wan 3.0·MiniMax H3·Seedance 2.5 비교: 납품 기준으로 먼저 테스트할 모델에서 후보를 고르세요.

LaoZhang API로 Muse 영상 만들기: 토큰 → 생성 → 폴링 → 다운로드

LaoZhang API의 Muse 영상은 비동기 작업입니다. POST /v1/videos는 몇 초 안에 작업 id만 돌려주고 영상이 완성되면 GET /v1/videos/{id} 응답에 video_url이 붙으므로, 생성 요청 한 번과 상태 조회 반복, 다운로드 한 번이면 끝납니다. 필드와 응답 형식은 LaoZhang API의 Muse 영상 생성 문서에 정리되어 있고, Sora 2와 같은 /v1/videos 요청 형식이라 예전 Sora 코드라면 model, seconds, 토큰만 바꾸면 됩니다. Sora 쪽 사정은 Sora 2 API 종료 이후: 남은 경로, 영상 보관, 대체 API에 있습니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

1. LaoZhang API 토큰 관리 화면에서 영상 전용 토큰을 하나 만듭니다. 그룹은 default, 과금 방식은 Usage first나 Per-call로 고르며, Usage-based only 토큰으로는 이 모델을 부를 수 없습니다.
2. POST /v1/videos에 model과 prompt를 보내고, 응답의 id를 자기 작업 ID와 짝지어 저장합니다.
3. 15초마다 GET /v1/videos/{id}로 status를 읽고, queued나 in_progress인 동안 최대 30분까지 계속 조회합니다.
4. completed가 되면 video_url에서 MP4를 받습니다. 이 링크는 Authorization 헤더 없이 받을 수 있고 7일 뒤 만료되므로 완성 즉시 저장합니다.

curl로는 다음과 같습니다. 응답에서 값을 꺼내는 데 jq를 씁니다.

export LAOZHANG_API_KEY="발급받은 키"
export BASE_URL="https://api.laozhang.ai"

# 1) 작업 생성: 정상이면 status가 queued인 작업과 id가 돌아온다
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "muse-video",
    "prompt": "A lighthouse on a rocky coast at dawn, waves crashing on the rocks, a few seagulls flying past, slow push-in, cinematic lighting",
    "seconds": "10",
    "aspect_ratio": "16:9"
  }' | tee muse-create.json

export VIDEO_ID=$(jq -r '.id' muse-create.json)

# 2) 상태 조회: completed가 될 때까지 15초 간격으로 반복
curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | jq '{status, progress, video_url}'

# 3) 다운로드: video_url은 인증 헤더 없이 받을 수 있다
curl -L -o muse-video.mp4 "$(curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | jq -r '.video_url')"

seconds를 빼면 muse-video는 10초를 만들고, aspect_ratio 대신 size에 720x1280처럼 픽셀 크기를 넣어도 됩니다. 인증 헤더를 붙여 GET /v1/videos/{id}/content를 부르면 MP4 파일이 바로 돌아오는 방법도 있습니다.

Python: id를 받지 못했을 때만 다시 보내는 최소 클라이언트

파이프라인에 넣을 때는 생성 요청이 작업 id를 돌려줬는지를 기준으로 재시도를 나눠야 합니다. 아래 코드는 id 없이 끝난 요청만 예외로 올리고, 폴링 시간이 다 돼도 작업을 새로 만들지 않습니다. requests가 필요합니다(pip install requests).

import os
import time

import requests

BASE_URL = "https://api.laozhang.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"}


def create_task(payload: dict) -> str:
    """작업 id를 돌려준다. 400·500처럼 id가 없는 응답은 작업이 만들어지지 않은 실패다."""
    resp = requests.post(f"{BASE_URL}/v1/videos", headers=HEADERS, json=payload, timeout=120)
    body = resp.json()
    if resp.status_code >= 400 or "id" not in body:
        raise RuntimeError(f"HTTP {resp.status_code}: {body.get('error')}")
    return body["id"]


def wait_for_video(video_id: str, limit_s: int = 30 * 60) -> dict:
    deadline = time.time() + limit_s
    while time.time() < deadline:
        video = requests.get(f"{BASE_URL}/v1/videos/{video_id}", headers=HEADERS, timeout=60).json()
        if video["status"] == "completed":
            return video
        if video["status"] == "failed":
            raise RuntimeError(video["error"]["message"])  # 이미 환불된 작업
        time.sleep(15)
    # 시간이 다 돼도 작업은 살아 있을 수 있다: 새로 만들지 말고 같은 id를 나중에 다시 조회
    raise TimeoutError(f"{video_id} is still running")


video_id = create_task({
    "model": "muse-video",
    "prompt": "A lighthouse on a rocky coast at dawn, waves crashing on the rocks, slow push-in",
    "seconds": "10",
    "aspect_ratio": "16:9",
})
print("task id:", video_id)  # 자기 작업 ID와 함께 저장
video = wait_for_video(video_id)

with open("muse-video.mp4", "wb") as f:
    f.write(requests.get(video["video_url"], timeout=300).content)  # 인증 헤더 불필요
print("saved:", video["seconds"], "s,", video.get("size"))

첫 프레임·끝 프레임·참조 이미지·이어 생성은 필드만 더합니다

이미지에서 영상을 만들 때도 같은 POST /v1/videos에 필드만 더합니다. image는 첫 장면을 정하고(멀티파트로 파일을 올릴 때 필드 이름은 input_reference), last_frame을 함께 보내면 끝 장면도 정해지며, 이미지는 공개 URL이나 data:image/...;base64, 형식으로 장당 10MB까지 보낼 수 있습니다. LaoZhang API 운영팀의 2026년 10월 30일 테스트에서 image와 last_frame으로 만든 8초 영상은 처음과 끝이 입력 이미지와 가까웠지만 픽셀 단위로 같지는 않았으므로, 로고 컷처럼 정확히 같은 프레임이 필요하면 편집 단계에서 원본 이미지를 붙이는 편이 안전합니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

reference_images는 첫 프레임으로 쓰지 않고 피사체와 스타일만 가져가는 참조 이미지로, 최대 4장까지 받습니다. 이미 있는 영상을 잇는 video_url은 muse-video-20s와 muse-video-30s에서만 받고, 원본은 누구나 내려받을 수 있는 https MP4에 10초 이하여야 하며, LaoZhang API가 돌려준 video_url도 원본으로 쓸 수 있습니다. 결과물에는 원본이 포함되고 20s 모델은 10초, 30s 모델은 20초를 뒤에 더하기 때문에, 5초 원본을 muse-video-20s로 이으면 15초 영상이 됩니다.

# 5초 원본 뒤에 10초를 이어 15초 영상 만들기
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "muse-video-20s",
    "prompt": "The boat drifts into the morning mist as the sun rises over the sea",
    "video_url": "https://example.com/boat-5s.mp4"
  }'

Muse 영상 출력 사양: 720p 등급·24fps·소리 포함, 1080p 지정은 무시

Muse 영상은 비율과 상관없이 720p 등급으로만 나옵니다. 이 블로그의 관계사인 LaoZhang API 운영팀이 출시 전인 2026년 10월 30일 muse-video 5초로 비율마다 한 편씩 만들어 ffprobe로 잰 기록을 보면, 모든 영상이 24fps에 AAC 오디오 트랙을 갖고 있었고 resolution: "1080p"와 fps: 30을 보내도 출력은 그대로 720p·24fps였습니다. 이 값들은 오류 없이 받아들여지기 때문에, 1080p를 보냈다는 이유로 1080p 파일을 기대하면 안 됩니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

같은 기록에서 aspect_ratio별 출력 크기는 16:9가 1280×720, 9:16이 720×1280, 1:1이 960×960, 4:3이 1088×816, 3:4가 816×1088이었습니다. 세로 쇼츠용이면 9:16으로 720×1280을 받고, 1080×1920이 필요한 플랫폼에는 업스케일을 거치거나 1080p를 내는 모델로 만들어야 합니다. 소리는 끌 수 없어서 무음 영상이 필요하면 받은 뒤 오디오 트랙을 지워야 합니다. 프롬프트는 20,000자까지 받고, style·camera_motion·negative_prompt는 문서상 생성 방향을 알려 주는 힌트로만 쓰입니다.

대기 시간은 길이에 따라 크게 다릅니다. 같은 10월 30일 기록에서 5~10초 영상은 대략 1.5~2.5분, 20초는 3~4분, 30초는 길게는 약 11분이 걸렸고, 등대 장면 프롬프트로 만든 10초 16:9 영상 두 편은 각각 약 103초와 약 395초로 네 배 가까이 차이가 났습니다. LaoZhang API 문서도 10초 이하 영상은 보통 2~3분, 붐비는 시간에는 5분 넘게 걸린다고 안내하므로, 타임아웃은 앞의 코드처럼 30분 폴링을 기준으로 잡습니다.

Muse 영상 비용 계산: 10초면 초당 $0.03, 60초는 $1.60~$1.80

LaoZhang API의 Muse 영상은 초가 아니라 편으로 과금됩니다. 한 모델 안에서는 길이, 비율, 입력 이미지와 상관없이 값이 같으므로, 2026년 11월 2일 기준 가격표의 편당 가격을 영상 길이로 나누면 초당 비용이 나옵니다. 그래서 muse-video는 길게 뽑을수록 초당 단가가 내려갑니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

60초 분량을 만든다면 30초 두 편이 $1.60으로 가장 싸고, 20초 세 편은 $1.65, 10초 여섯 편은 $1.80입니다. 이미 만든 10초 영상을 muse-video-20s로 이어 20초로 만들면 두 작업 합계가 $0.85로 처음부터 20초 한 편을 만드는 것보다 비싸므로, 이어 생성은 특정 컷을 꼭 이어야 할 때만 씁니다. 품질 때문에 후보를 여러 편 뽑으면 그 수만큼 과금되어 10초 후보 세 편이면 $0.90이 되니, 예산은 최종 편수가 아니라 생성 횟수로 잡아야 합니다. 다른 영상 모델의 초당 가격대와 60초 예산은 AI 동영상 생성 비용: 초당 가격 비교와 60초 영상 예산에서 비교할 수 있습니다.

Muse 영상 API 오류와 과금: 작업 id를 받았는지로 재전송을 판단합니다

다시 보내도 되는지는 생성 요청이 작업 id를 돌려줬는지로 판단합니다. LaoZhang API는 작업이 만들어질 때 과금하고 실패한 작업은 전액 환불하며, 다시 보내면 새 작업으로 다시 과금합니다. 그래서 id가 없는 오류는 다시 보내도 비용이 들지 않지만, id를 받은 작업은 끝날 때까지 같은 id를 조회해야 합니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

2026년 11월 1일 23시 37분(UTC)에 default 그룹 Per-call 토큰으로 잘못된 요청 세 건을 직접 보냈을 때 결과는 표의 첫 줄과 같았습니다. muse-video에 seconds: "12"를 보내면 seconds must be 5, 8, 10 for muse-video., muse-video에 video_url을 넣으면 video_url (continue a video) needs muse-video-20s or muse-video-30s., 참조 이미지를 5장 보내면 Send at most 4 reference_images.가 HTTP 400과 함께 약 1초 만에 돌아왔고, 계정 사용액은 요청 전후로 그대로였습니다.

같은 날 23시 37분부터 11월 2일 0시 7분(UTC)까지 약 30분 동안은 형식이 올바른 생성 요청도 모두 실패했습니다. Per-call 토큰과 Usage first 토큰 두 개로, 문서의 등대 예제를 그대로 보낸 요청까지 1.2초 안팎에 HTTP 500과 {"error":{"code":"task_protocol_error","message":"Task protocol request failed","type":"new_api_error"}}가 돌아왔고, 작업 id도 과금도 없었습니다. 요청 내용이 아니라 중계 쪽 장애이므로 다시 보내도 과금 위험은 없지만, 5분 간격으로 다시 보낸 요청도 이 30분 동안 모두 같은 오류였습니다. 그래서 이 시간대에는 완성 영상을 받지 못했고, 앞에서 다룬 출력 사양과 대기 시간은 LaoZhang API 운영팀의 10월 30일 기록에 기댄 값입니다.

Muse Video API 자주 묻는 질문

같은 프롬프트로 같은 Muse 영상을 다시 만들 수 있나요?

보장되지 않습니다. 2026년 11월 2일 기준 LaoZhang API의 Muse 영상 문서에는 결과를 고정하는 seed 필드가 요청 필드 목록에 없고, style·camera_motion·negative_prompt도 힌트로만 쓰입니다. 같은 프롬프트로 다시 만들면 새 작업으로 과금되고 결과도 달라질 수 있으니, 마음에 드는 영상은 링크가 만료되는 7일 안에 파일로 보관해야 합니다.

n8n에서 Muse 영상 생성을 자동화할 수 있나요?

HTTP 요청 세 개로 구성할 수 있습니다. HTTP Request 노드로 POST /v1/videos를 보내 id를 저장하고, Wait 노드로 15초 쉰 뒤 GET /v1/videos/{id}를 status가 completed나 failed가 될 때까지 반복한 다음, video_url을 받아 저장하면 됩니다. 생성 노드에 실패 시 자동 재시도를 켜 두면 응답이 늦게 온 작업까지 새로 만들어 두 번 과금될 수 있으니, 재시도는 응답에 id가 없을 때로 한정합니다.