Muse Video API Reference

Generate 10-second 720p Muse Video clips with sound from a prompt or up to 9 reference images, in seven aspect ratios, priced per clip and delivered as a task.

Muse Video is the video model from Meta Superintelligence Labs. One request makes a clip of about 10 seconds at 720p with sound, from a prompt or from a prompt plus up to 9 reference images, in one of seven aspect ratios. Send the request, keep the returned task ID, and read the finished video from the task. Reference images go in as URLs.

Model IDs

Model ID	Inputs	Resolution	Length
`muse-video`	text, 0–9 images	`720p`	about 10 seconds, with sound

See the model page for current prices.

Quick example

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Header	Value
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

The response is a task ({"id": "task_...", "status": "processing"}), not the finished video. Poll GET /v1/tasks/{task_id} for the result. Keep API keys in server-side code.

Parameters

Field	Type	Default	Notes
`model`	string	required	`muse-video`
`prompt`	string	required	Must not be empty after trimming. Required with references too.
`image_urls`	URL list	none	0–9 public image URLs, 11 MB in total. Without them the request is text to video.
`aspect_ratio`	enum	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` or `2:3`. Leave it out for auto: references set the shape; text only gives `16:9`. Do not send `"auto"`.
`size`	enum	none	Compatibility alias of `aspect_ratio`: one of the ratios above, or `auto`. When both are valid, `aspect_ratio` wins.
`duration`	integer or string	`10`	Only `10`, `"10"` or `"10s"`. The clip runs about 10 seconds.
`resolution`	enum	`720p`	Only `720p`.
`audio`	boolean	`true`	Only `true`; every clip has sound. `false` is refused.
`n`	integer	`1`	Only `1`. Each request returns one clip.

Fields outside this list are dropped before the request is forwarded; they never cause an error and never change the output. There are no first or last frame, reference video, reference audio, extend, seed or negative prompt settings. callback_url is not available; poll the task instead.

Reference images

Pass up to 9 images in image_urls and describe the motion in prompt. Muse Video uses them as references: the clip stays close to them, but the first frame is not a pixel copy. With aspect_ratio left out, the clip follows their shape.

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

Media inputs

Each reference is a public HTTP(S) URL. Base64 data URIs are not accepted: upload the file to your own storage and pass its URL. Use PNG, JPEG or WebP images; the original files must total 11 MB or less across all references. A set over that limit fails after acceptance and is not charged.

Pricing dimensions

Check the model pricing section for current rates. Muse Video has one price per clip:

cost = price per clip × 1

The price is not multiplied by seconds. Text-only and reference requests, and every aspect ratio, cost the same. The amount reserved when the task is accepted is the amount charged. View final charges in your account usage history. Failed tasks are not charged.

Output schema

Submission returns the task:

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

Get the task

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Poll every 10–20 seconds until status is completed or failed. A network timeout while polling does not mean generation failed: keep the task ID and resume checking it. Do not create another task to check progress.

Completed task

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

In our tests the clips came back as 10.0-second MP4 (H.264) files with an AAC audio track: 1280 × 720 for 16:9, 720 × 1280 for 9:16, and 1248 × 704 for a reference with a 16:9 shape, about 100–200 seconds after submission.

Errors

Requests rejected before a task is created return an HTTP error with an error object and are not charged. A task that fails after acceptance returns HTTP 200 when queried, with status: "failed" and an error object.

See the shared error catalog for codes, HTTP statuses, and retry guidance.

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

If submission itself times out, check your tasks before submitting again: the first request may have been accepted.

Tips

Describe subject, action, camera move and light, and name the sounds you want; the audio is generated together with the picture.
Make a still with Muse Image, then pass its URL here to set it in motion.
For vertical video, send aspect_ratio: "9:16", or a portrait reference.
Add no text to keep invented captions out.

Muse Video

On this page