> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Muse 비디오 API: 요금과 최대 60초 생성

> /v1/videos로 5~60초 비디오를 소리와 함께 만듭니다. 텍스트, 첫·마지막 프레임, 참조 이미지, 이어 만들기 요청 예제와 비디오당 요금을 안내합니다.

Muse는 Meta의 비디오 생성 모델입니다. 모든 클립에 음악과 효과음이 들어가며, 요청 한 번으로 최대 60초의 연속된 클립을 받을 수 있습니다. LaoZhang API는 비디오당 과금하며 5\~10초는 \$0.30, 60초는 \$1.55이고, 표준 토큰 그룹이면 모두 호출할 수 있습니다.

| 항목 | 내용 |
| - | - |
| 모델 ID | `muse-video`(5, 8, 10초), `muse-video-20s`~~`muse-video-60s`(20~~60초, 10초 단위로 모델 하나씩) |
| 작업 생성 | `POST /v1/videos`, JSON 또는 multipart |
| 작업 조회 | `GET /v1/videos/{id}`. 완료되면 `video_url`을 읽습니다 |
| 다운로드 | `video_url`을 직접 쓰거나 `GET /v1/videos/{id}/content` |
| 토큰 그룹 | `default`, `vip`, `svip` (과금 방식은 사용량 우선) |
| 가격 | 비디오당 \$0.30\~\$1.55. 아래 요금 절 참고 |
| 출력 | 24fps, 사운드트랙 포함. 16:9는 1280×720이며 다른 크기는 아래 요청 필드 절 참고 |
| 보관 기간 | 비디오 링크는 7일간 유지됩니다 |
| 경로 | Meta 공식 API에는 아직 비디오 생성 모델이 없습니다. 이 경로는 독자적으로 연동했으며 별도 가격이 적용됩니다 |

![Muse 텍스트 투 비디오 샘플: 새벽 바위 해안의 등대와 바위에 부서지는 파도](https://mintcdn.com/laozhangai-edd05f2c/HNpi8TQdPfniogkz/images/samples/muse-video-en-t2v.jpg?fit=max\&auto=format\&n=HNpi8TQdPfniogkz\&q=85\&s=cbb313bc8cdeb5db903cd14e366f2d43)

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

## API 키 만들기

[토큰 관리](https://api.laozhang.ai/token)에서 다음 설정으로 API 키(콘솔에서는 '토큰'이라고 부릅니다)를 추가하세요.

| 설정 | 선택 |
| - | - |
| 그룹 | `default`, `vip`, `svip`. 세 그룹의 가격은 같습니다 |
| 과금 방식 | 사용량 우선(콘솔 표시: 按量优先, 권장) 또는 건당 과금(按次计费). 사용량 과금(按量计费)만 설정한 키는 호출할 수 없습니다 |
| 팁 | 비디오 전용 키를 따로 만들면 호출 로그에서 청구 내역과 작업을 맞춰 보기 쉽습니다 |

Meta 계정이나 별도의 비디오 전용 그룹은 필요하지 않습니다.

## 요금

Muse 비디오는 한 편 단위로 과금합니다. 모델 안에서 고른 길이, 종횡비, 이미지 전송 여부에 따라 가격이 달라지지 않습니다.

| 모델 | 클립 길이 | 비디오당 |
| - | - | -: |
| `muse-video` | 5, 8, 10초 | \$0.30 |
| `muse-video-20s` | 20초. 이어 만든 비디오는 원본을 포함해 총 20초 | \$0.55 |
| `muse-video-30s` | 30초. 이어 만든 비디오는 원본을 포함해 총 30초 | \$0.80 |
| `muse-video-40s` | 40초. 이어 만든 비디오는 원본을 포함해 총 40초 | \$1.05 |
| `muse-video-50s` | 50초. 이어 만든 비디오는 원본을 포함해 총 50초 | \$1.30 |
| `muse-video-60s` | 60초. 이어 만든 비디오는 원본을 포함해 총 60초 | \$1.55 |

과금 방식은 다음과 같습니다.

* 작업을 만들 때 과금되며, 실패한 작업은 전액 환불됩니다.
* 파라미터 오류로 제출 단계에서 거부된 요청은 과금되지 않습니다.
* 다시 제출하면 새 작업이 만들어져 다시 과금되므로, 자체 작업 ID와 작업 `id`의 대응 관계를 보관하세요.

작업별 실제 청구 금액은 [호출 로그](https://api.laozhang.ai/log)에서 확인할 수 있습니다.

## 비디오 모델 고르기

2026년 10월 31일 기준으로, 720p 이상 10초 클립에서 LaoZhang API의 비디오 모델 중 Muse가 가장 저렴합니다. 비디오당 고정 가격이 필요하거나, 20\~60초의 연속된 클립이 필요하거나, 기존 비디오를 이어 만들 때 사용하세요.

2K, 참조 비디오, 참조 오디오가 필요하면 [MiniMax H3](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)를 쓰세요. 1080p는 Seedance 또는 Wan을 쓰세요. 모델별 5초·10초 클립 비용과 엔드포인트는 [비디오 API 비교](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md)에 정리되어 있습니다.

## 샘플 출력

아래 클립은 편집하지 않은 Muse 출력이며 모델이 만든 사운드트랙이 들어 있습니다. 클립을 눌러 재생하세요. 각 캡션에는 모델, 길이, 종횡비, 프롬프트가 있습니다.

[MiniMax H3 샘플 출력](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)은 같은 프롬프트를 쓰므로 장면별로 두 모델을 비교할 수 있습니다.

<video controls preload="none" poster="/images/samples/muse-video-sample-fox-5s.jpg" src="https://media.laozhang.ai/samples/video/muse-fox-5s.mp4" />

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

<video controls preload="none" poster="/images/samples/muse-video-sample-fox-extend-20s.jpg" src="https://media.laozhang.ai/samples/video/muse-fox-extend-20s.mp4" />

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

<video controls preload="none" poster="/images/samples/muse-video-sample-paper-boat-20s.jpg" src="https://media.laozhang.ai/samples/video/muse-paper-boat-20s.mp4" />

muse-video-20s, 20초, 16:9. 프롬프트: A paper boat drifts down a rainy city gutter, then sails into a small sunny pond

<video controls preload="none" poster="/images/samples/muse-video-sample-paper-boat-extend-40s.jpg" src="https://media.laozhang.ai/samples/video/muse-paper-boat-extend-40s.mp4" />

muse-video-40s로 앞의 20초 클립을 40초 클립으로 이어 만든 결과. 프롬프트: The paper boat sails across the pond, passes under a wooden bridge and reaches a garden fountain

<video controls preload="none" poster="/images/samples/muse-video-sample-hot-air-balloon-40s.jpg" src="https://media.laozhang.ai/samples/video/muse-hot-air-balloon-40s.mp4" />

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

<video controls preload="none" poster="/images/samples/muse-video-sample-cyclist-50s-9x16.jpg" src="https://media.laozhang.ai/samples/video/muse-cyclist-50s-9x16.mp4" />

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초 이하 클립은 보통 2~~3분 안에 끝나며 혼잡할 때는 5분이 넘기도 합니다. 20~~30초 클립은 약 4~~10분, 40~~60초 클립은 약 5\~10분 걸립니다.

**3. 결과 다운로드**

`status`가 `completed`가 되면 `video_url`에서 MP4를 내려받습니다. 다운로드에는 `Authorization` 헤더가 필요 없고, 링크는 7일간 유효합니다.

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

## 환경 설정

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

```bash theme={null}
export LAOZHANG_API_KEY="LaoZhang API 키"
export BASE_URL="https://api.laozhang.ai"
```

## 텍스트로 비디오 만들기

아래 요청의 프롬프트는 위 샘플 이미지를 만든 영어 프롬프트 그대로입니다.

```bash theme={null}
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)
```

요청이 성공하면 대기 중인 작업이 반환됩니다.

```json theme={null}
{
  "id": "task_qyP7fa67hjtpArfMjnAnOwpVe1UEgyHh",
  "object": "video",
  "model": "muse-video",
  "status": "queued",
  "progress": 0,
  "seconds": "10",
  "created_at": 1793328222
}
```

자주 쓰는 선택 필드는 두 가지입니다.

* `seconds`: 생략하면 `muse-video`는 10초 클립을 만듭니다.
* `aspect_ratio`: 클립의 비율입니다. `720x1280`처럼 픽셀 단위 `size`를 대신 보낼 수도 있습니다. 첫 프레임이나 참조 이미지를 보낼 때도 적용되며, 자세한 내용은 아래 이미지와 종횡비 절에 있습니다.

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

`image`로 시작 장면을 지정하고, `last_frame`을 더하면 끝 장면도 지정할 수 있습니다. 각 이미지는 공개 URL 또는 `data:image/...;base64,` 데이터 URL이어야 합니다.

```bash theme={null}
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": "눈이 녹고 나뭇잎이 황금빛으로 물들며 겨울이 가을로 바뀝니다",
    "seconds": "8",
    "image": "https://example.com/winter.jpg",
    "last_frame": "https://example.com/autumn.jpg"
  }'
```

모델은 두 이미지를 시각적 참조로 사용합니다. 클립은 같은 구도로 시작하고 끝나지만 세부 요소가 픽셀 단위로 똑같이 재현되지는 않습니다.

로컬 파일을 올리려면 multipart 폼 데이터를 보냅니다. 첫 프레임은 `input_reference`에, 마지막 프레임은 `last_frame`에 넣습니다.

```bash theme={null}
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F model=muse-video \
  -F prompt="새끼 고양이가 눈을 깜빡이고 하품합니다" \
  -F seconds=5 \
  -F aspect_ratio=9:16 \
  -F input_reference=@./cat.jpg
```

`-F`로 업로드할 때는 `Content-Type: application/json`을 설정하지 마세요. 이미지는 한 장당 최대 10MB입니다.

## 참조 이미지로 만들기

`reference_images`에 이미지를 1\~4장 보냅니다. 모델은 이미지의 피사체와 스타일을 비디오에 반영하며, 어느 이미지도 첫 프레임으로 쓰지 않습니다.

```bash theme={null}
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": "이 여우가 겨울에서 가을로 바뀌는 숲속을 걷습니다",
    "seconds": "10",
    "aspect_ratio": "16:9",
    "reference_images": [
      "https://example.com/fox-winter.jpg",
      "https://example.com/fox-autumn.jpg"
    ]
  }'
```

### 이미지와 종횡비

첫 프레임, 마지막 프레임, 참조 이미지를 보낼 때 클립의 비율은 다음과 같이 정해집니다.

* **`aspect_ratio`(또는 `size`)를 보낸 경우**: 생성 전에 각 이미지를 해당 비율로 중앙 크롭하고, 클립도 그 비율로 나옵니다. 크기는 아래 요청 필드 절에 있습니다.
* **보내지 않은 경우**: 클립이 이미지 자체의 비율을 따릅니다. 3:2 가로 사진이면 1152×768이 됩니다.

중앙 크롭은 이미지의 좌우 또는 위아래를 잘라 냅니다. 피사체가 가장자리에 있다면 업로드하기 전에 목표 비율로 직접 잘라서 구도를 정하세요.

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

긴 모델은 각각 이름에 적힌 길이(20\~60초)의 연속된 클립 하나를 만듭니다. 가격은 위 요금 절에 있습니다. 호출 방법은 `muse-video`와 같고 `seconds`는 생략할 수 있습니다.

기존 클립에서 이어 만들려면 `video_url`을 보냅니다.

```bash theme={null}
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": "배가 아침 안개 속으로 흘러가고 바다 위로 해가 떠오릅니다",
    "video_url": "https://example.com/boat-5s.mp4"
  }'
```

이어 만들기 규칙은 다음과 같습니다.

* `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`도 원본으로 쓸 수 있습니다.

## 조회와 다운로드

### 작업 조회

```bash theme={null}
curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY"
```

비디오를 렌더링하는 동안 `status`는 `in_progress`이고 `progress`에 대략적인 진행률이 표시됩니다.

```json theme={null}
{
  "id": "task_1OuWjS9JUWpjiin8zr3S3vzhQNjTILIF",
  "object": "video",
  "model": "muse-video",
  "status": "in_progress",
  "progress": 30,
  "seconds": "10",
  "size": "1280x720",
  "created_at": 1793328220
}
```

완료되면 작업에 `video_url`이 포함됩니다.

```json theme={null}
{
  "id": "task_Qb8zDoLJMSDsOKdRWLMCwzRgkg2EanF0",
  "object": "video",
  "model": "muse-video",
  "status": "completed",
  "progress": 100,
  "seconds": "5",
  "size": "1280x720",
  "created_at": 1793325393,
  "completed_at": 1793325521,
  "video_url": "https://media.laozhang.ai/videos/video_6efb7e6d2b37665752192eb1-a95d03b30c0f.mp4"
}
```

실패한 작업은 `status: "failed"`이고 사유가 `error.message`에 있습니다. 청구 금액은 이미 환불되었습니다.

```json theme={null}
{
  "id": "task_GcyZA3g7We2nQOl3QaSQX1nroSKli3O7",
  "object": "video",
  "model": "muse-video",
  "status": "failed",
  "progress": 100,
  "seconds": "8",
  "size": "1280x720",
  "created_at": 1793326360,
  "error": {
    "code": "video_generation_failed",
    "message": "Could not download last_frame (HTTP 429). Use a public image link or a data URL."
  }
}
```

### 비디오 다운로드

```bash theme={null}
curl -L -o muse-video.mp4 "$(curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | jq -r '.video_url')"
```

`Authorization` 헤더와 함께 `GET /v1/videos/{id}/content`를 호출해도 MP4 파일이 반환됩니다.

## 최소 Python 클라이언트

`requests`가 필요합니다(`pip install requests`).

```python theme={null}
import os
import time

import requests

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

task = requests.post(
    f"{BASE_URL}/v1/videos",
    headers=HEADERS,
    json={
        "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",
    },
    timeout=120,
)
task.raise_for_status()
video_id = task.json()["id"]

deadline = time.time() + 30 * 60
while True:
    video = requests.get(f"{BASE_URL}/v1/videos/{video_id}", headers=HEADERS, timeout=60).json()
    if video["status"] == "completed":
        break
    if video["status"] == "failed":
        raise RuntimeError(video["error"]["message"])
    if time.time() > deadline:
        raise TimeoutError(f"{video_id} 작업이 아직 진행 중입니다. 나중에 같은 id로 계속 조회하세요")
    time.sleep(15)

with open("muse-video.mp4", "wb") as f:
    f.write(requests.get(video["video_url"], timeout=300).content)
print("muse-video.mp4 저장 완료,", video["seconds"], "초")
```

## API 레퍼런스

### 요청 필드

| 필드 | 필수 | 설명 |
| - | - | - |
| `model` | 필수 | `muse-video`, `muse-video-20s`, `muse-video-30s`, `muse-video-40s`, `muse-video-50s`, `muse-video-60s` 중 하나 |
| `prompt` | 필수 | 화면에서 일어나는 일과 들리는 소리. 최대 20,000자이며 전부 사용됩니다 |
| `seconds` | 선택 | `muse-video`는 `5`, `8`, `10`(기본값 10). 긴 모델은 모델 이름에 적힌 길이이며 생략할 수 있습니다 |
| `aspect_ratio` | 선택 | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`. 이미지를 보내면 먼저 이 비율로 중앙 크롭하고, 보내지 않으면 이미지의 비율을 따릅니다 |
| `size` | 선택 | `1280x720`이나 아래 표의 출력 크기 같은 픽셀 단위 비율. `aspect_ratio` 대신 사용합니다 |
| `image` | 선택 | 첫 프레임. multipart 필드 이름은 `input_reference`입니다 |
| `last_frame` | 선택 | 마지막 프레임 |
| `reference_images` | 선택 | 참조 이미지 배열(최대 4장) |
| `video_url` | 선택 | 이어 만들 원본 클립. 20s\~60s 모델 전용 |
| `negative_prompt` | 선택 | 비디오에서 제외할 요소 |
| `style`, `camera_motion` | 선택 | `cinematic`, `zoom_in` 같은 스타일과 카메라 힌트이며 가이드로 쓰입니다 |

종횡비별 출력 크기입니다.

| `aspect_ratio` | 출력 크기 |
| - | - |
| `16:9` | 1280×720 |
| `9:16` | 720×1280 |
| `1:1` | 960×960 |
| `4:3` | 1088×816 |
| `3:4` | 816×1088 |

이미지를 보내면 같은 비율에서도 크기가 표와 수십 픽셀 다를 수 있습니다. 예를 들어 16:9는 1248×704, 4:3은 1056×800이 되기도 합니다. 프레임 레이트는 항상 24fps이며 `resolution`과 `fps`는 출력을 바꾸지 않습니다.

### 작업 상태

| `status` | 의미 | 다음 단계 |
| - | - | - |
| `queued` | 생성되어 렌더링을 기다리는 중 | 계속 조회 |
| `in_progress` | 렌더링 중 | 계속 조회 |
| `completed` | 완료 | `video_url`에서 다운로드 |
| `failed` | 실패하고 환불됨 | `error.message`에 맞게 요청을 고쳐 새 작업 생성 |

## 오류

| 오류 | 원인 | 해결 |
| - | - | - |
| `seconds must be 5, 8, 10 for muse-video.` | 이 모델이 제공하지 않는 길이 | 5, 8, 10 중 하나를 쓰거나 20s\~60s 모델로 바꾸세요 |
| `video_url (continue a video) needs muse-video-20s, -30s, -40s, -50s or -60s.` | `muse-video`에 이어 만들기를 요청함 | `muse-video-20s`\~`muse-video-60s` 중 하나를 쓰세요 |
| `Send at most 4 reference_images.` | 참조 이미지가 4장을 넘음 | 4장 이하로 보내세요 |
| `Could not download image (HTTP 403)…` | 이미지 링크가 로그인을 요구하거나 다운로드를 막거나 속도 제한이 걸려 있음 | 누구나 내려받을 수 있는 링크를 쓰거나 데이터 URL로 보내세요 |
| `image must be a public internet link.` | 이미지 링크가 사설, 로컬, 해석 불가 주소를 가리킴 | 누구나 내려받을 수 있는 링크를 쓰거나 데이터 URL로 보내세요 |
| `video_url can be at most 18 seconds long…` | 원본이 모델이 허용하는 길이보다 김(결과보다 2초 짧아야 함. 20s 모델이면 18초) | 원본을 자르거나 더 긴 모델을 쓰세요 |
| `The model returned no video for this input…` | 이 입력으로 모델이 비디오를 만들지 못함 | 프롬프트를 조정하거나 다른 이미지를 쓰고 새 작업을 만드세요 |
| `prompt must be at most 20000 characters.…` | 프롬프트가 20,000자보다 김 | 20,000자 이하로 줄이세요 |

처음 세 가지는 제출 시점에 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일입니다. 이후에는 링크가 만료되어 작업을 다시 내려받을 수 없으니 작업이 완료되면 파일을 저장하세요.

## 관련 문서

* [비디오 생성 API 비교와 가격](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md)
* [MiniMax H3 비디오 API](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)
* [Seedance 2.0 비디오 API](https://docs.laozhang.ai/ko/api-capabilities/seedance2-video-generation.md)
* [Wan 2.7·Wan 3.0 비디오 API](https://docs.laozhang.ai/ko/api-capabilities/wan-video-generation.md)
* [모델 및 가격](https://docs.laozhang.ai/ko/models.md)
* [호출 로그](https://docs.laozhang.ai/en/faq/call-logs.md)
* [Meta Model API 모델](https://dev.meta.ai/resources/blog/build-with-muse-spark): Muse Spark, Muse Image 등이 있으며 비디오 생성 모델은 없습니다(2026년 10월 30일 확인)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.