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

# Muse Video Reference to Video

> Generate a Meta Muse Video clip of about ten seconds at 720p with native sound and per-request billing.

Muse Video is a native-audio video model introduced by Meta Superintelligence Labs. Use one to nine reference images to guide a short scene. These integration-specific model IDs do not claim a direct Meta developer endpoint or a numbered Muse release.

| Property | Value |
| - | - |
| Public model ID | `muse-video-r2v` |
| Output | One MP4 with sound, approximately 10 seconds, 720p |
| Request settings | `seconds: 10`, `resolution: "720p"`, `n: 1` |
| Price | \$0.036 per generated clip (3.6 SnapGen credits) |
| References | 1–9 images; original files total at most 11 MiB |

**100 SnapGen credits = \$1**. Both modes have the same per-request price. The completed file determines its actual duration and dimensions. Confirm current availability on the [Muse Video model page](https://snapgen.org/models/muse-video).

**model** `string` *required*

Use `muse-video-r2v`.

**prompt** `string` *required*

A non-empty scene description, at most 100,000 characters under the gateway
limit.

**seconds** `integer` (default: 10)

Only the JSON number `10` is accepted. Actual output duration is approximately
ten seconds.

**resolution** `string` (default: 720p)

Only `720p` is accepted.

**n** `integer` (default: 1)

Only `1` is accepted.

**generate\_audio** `boolean` (default: true)

Native sound is always included. Only `true` is accepted.

**aspect\_ratio** `string` (default: adaptive)

`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` or `2:3`. `adaptive` is also
accepted and follows the reference framing.

**image\_urls** `string[]` *required*

One to nine public HTTP(S) PNG, JPEG or WebP URLs. The original files must
total at most **11 MiB (11,534,336 bytes) combined**, not per image. The
gateway measures the files before submitting the job. Data URLs, private and
credentialed URLs are not accepted.

References guide the scene; they do not guarantee a pixel-identical first frame. The route does not expose first/last-frame controls, input video or audio, masks, editing, remix or extension. Unsupported controls are rejected before submission.

## Request

```bash theme={null}
curl https://api.snapgen.org/v1/videos \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "muse-video-r2v",
  "prompt": "A paper boat floating on a quiet pond, a steady camera and gentle water sounds",
  "seconds": 10,
  "resolution": "720p",
  "aspect_ratio": "adaptive",
  "n": 1,
  "generate_audio": true,
  "image_urls": [
    "https://example.com/reference.jpg"
  ]
}'
```

## Poll and download

Save the returned gateway video `id`. Poll with the same API key and model ID until `status` is `completed` or `failed`. Download only after completion.

```bash theme={null}
curl "https://api.snapgen.org/v1/videos/$VIDEO_ID?model=muse-video-r2v" \
  -H "Authorization: Bearer $SNAPGEN_API_KEY"

curl -L "https://api.snapgen.org/v1/videos/$VIDEO_ID/content?model=muse-video-r2v" \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  --output video.mp4
```

Keep polling an existing task after a client timeout. Repeated status checks do not create a new generation. Save the MP4 promptly and respect any returned expiry time. See the [video workflow](https://docs.snapgen.org/api-reference/video-generation.md) for task states and error handling.

> [card] [Open Muse Video](https://snapgen.org/models/muse-video)
>
> Try text and reference generation with the live per-request price.


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