APIMart
Video

Muse Video API

Generate a video from a prompt or up to nine reference images with Muse Video API. Retrieve one MP4 clip with sound at 720p, approximately 10 seconds long, through the task API.

Video generation

Service Highlights

  • Official Discounts
  • Pay-as-you-go
  • Fast & Low Latency
Input
Reference Image

Optional: up to 9 images, 11 MiB total. Auto follows the reference aspect ratio.

Output

No generations yet.

Muse Video API Pricing

Transparent pricing with no hidden fees. Pay only for what you use.

VariantGoldCurrent pricePlatinumDiamondOfficialYour savings
muse-video-ext0.24Credits(~$0.024)/gen0.228Credits(~$0.0228)/gen0.216Credits(~$0.0216)/gen0.3Credits(~$0.03)/gen20%

* Actual costs are subject to final output.

Build with Muse Video API

Generate a video from a prompt or up to nine reference images with Muse Video API. Retrieve one MP4 clip with sound at 720p, approximately 10 seconds long, through the task API.

What Muse Video API supports

Generation modes, inputs and output specifications for your application.

Text to video with Muse Video API

Describe the subject, action and camera movement in a nonempty prompt. Submit without reference images for text-to-video generation.

Reference images with Muse Video API

Supply up to nine images alongside a prompt. URL, Data URI and base64 inputs are supported; the original images must total no more than 11 MiB.

Seven aspect ratios for Muse Video

Choose 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 or 2:3. Auto omits aspect_ratio so reference-image requests can follow the reference aspect ratio.

720p video with sound from the Muse Video Model

Each request produces one MP4 video with sound, approximately 10 seconds long. Read the delivered file for its actual duration and dimensions.

Use muse-video-ext in your requests

Send the complete model ID muse-video-ext to /v1/videos/generations to start a generation task.

Asynchronous tasks with Muse Video API

Submit once and save the task ID, then query its status. Reuse the same idempotency key and request body if an interrupted submission needs to be retried.

Muse Video API pricing

Review the live pricing for your account before generating. Final task cost and your account statement determine the charge. Each request is billed per video clip, not per second.

Retrieve and save Muse Video results

Read the result URL after the task reaches completed. If the response includes expires_at, download or archive the file before that time.

What you can create with Muse Video API

Plan each brief around the content you want to produce and review the delivered result.

Storyboards with Muse Video API

Turn a shot brief into a short video concept. Describe the action and camera movement, then review the delivered clip.

Product stories with Muse Video

Use reference images and a prompt to explore a product scene. Review appearance, motion and sound before using the footage.

Campaign clips with Muse Video API

Plan a short scene around one campaign message. Use your editing tools to add titles and assemble the final campaign.

Reference-led scenes with muse-video-ext

Describe how the subject and camera should move around your references. Reference images do not guarantee a pixel-identical first frame.

Social video with Muse Video

Choose a supported portrait, square or landscape ratio. Review the clip and its audio for the intended placement.

Video tools powered by Muse Video API

Integrate submission, task status and MP4 playback into your application. Store the task ID so interrupted sessions can resume querying.

How to get a Muse Video API key and start building

Set up your key, prepare your brief and organize your results.

1

Get your Muse Video API key

Sign in to APIMart and create a key in API Keys. Keep the key on your server, outside browser code and public repositories.

2

Prepare a focused creative brief

Describe the intended result and its context. Keep the brief with your request so you can compare revisions.

3

Review and integrate the output

Check the output against your brief before using it. Keep your selected assets organized for the next stage of production.

Muse Video API examples and integration

Submit muse-video-ext to /v1/videos/generations, save the task ID and query GET /v1/tasks/{task_id} for the result.

  1. 1

    Authenticate Muse Video API requests

    Store your API key on the server and send it as Authorization: Bearer <key>. Create one Idempotency-Key for each new generation operation.

  2. 2

    Submit a muse-video-ext task

    POST to /v1/videos/generations with model and prompt. The default response provides data[0].task_id; preserve the same key and body when retrying an interrupted submission.

  3. 3

    Retrieve the Muse Video result

    Query GET /v1/tasks/{task_id} until completed or failed. Read data.result.videos[0].url[0] on success, or data.error.message on failure; a local wait timeout is not task failure.

    See the Muse Video API reference for request and response details.

POST /v1/videos/generations
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "muse-video-ext",
    "prompt": "Waves gently wash over a beach at sunset, the camera pans slowly, natural ocean sound, no text",
    "n": 1,
    "aspect_ratio": "16:9",
    "duration": 10,
    "resolution": "720p"
  }'

Muse Video API parameters

ParameterTypeRequiredDefaultDescription
modelstringRequiredDefault: —Required model identifier: muse-video-ext.
promptstringRequiredDefault: —A nonempty text prompt after trimming whitespace; required with or without references. Chinese and English are supported.
image_urlsstring[]OptionalDefault: —Up to nine accessible image URLs, Data URIs or base64 strings; original images total at most 11 MiB. Omit when there are no references.
aspect_ratiostringOptionalDefault: —1:1, 16:9, 9:16, 4:3, 3:4, 3:2 or 2:3. For Auto, omit this field; do not send "auto". Without references the default is 16:9; with references it follows their aspect ratio.
nintegerOptionalDefault: 1Only the number 1 is supported. One request produces one result.
durationinteger | stringOptionalDefault: 10Fixed request duration: 10, "10" or "10s"; the numeric value 10 is recommended. Actual video duration may vary.
resolutionstringOptionalDefault: 720pOnly 720p is supported. Send the lowercase value 720p or omit the field.
nsfw_checkbooleanOptionalDefault: falseEnable platform content screening before submission. Successful submission does not guarantee that every moderation check has passed.

Explore the Muse APIs

Choose the Muse page for the type of content your project needs.

Muse Image API

Muse Video API FAQ

What is Muse Video API?

Muse Video API supports text-to-video and reference-image video generation through APIMart. The muse-video-ext model returns one MP4 video with sound at 720p, approximately 10 seconds long.

Which model ID does Muse Video API use?

Use muse-video-ext, including -ext, as the model value in your request.

How do I get a Muse Video API key?

Sign in to APIMart and create an API key in API Keys. Keep it on your server and send Authorization: Bearer <key> when submitting and querying tasks.

How many reference images does Muse Video support?

Use zero to nine reference images, with a combined original size of at most 11 MiB. Send them in image_urls as accessible URLs, Data URIs or base64; a prompt is required even with references.

Which aspect ratios does Muse Video API support?

Supported ratios are 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 and 2:3. Auto means omitting aspect_ratio: with references the composition follows them, while text-only requests default to 16:9.

Can I change Muse Video duration, resolution or audio?

The supported settings are approximately 10 seconds, 720p and sound enabled. Use duration: 10 and resolution: "720p" or their defaults; audio: false is rejected. Actual playback duration comes from the delivered file.

Does Muse Video API support first frames, last frames or extensions?

There are no dedicated first-frame, last-frame, reference-video, reference-audio or extension controls. Supply reference images through image_urls and describe the intended scene in the prompt.

What if a Muse Video API task takes longer than the page wait?

Keep its task ID and query it again later. A browser timeout or stopped polling does not cancel the server task; do not create another generation request automatically.

How is Muse Video API pricing calculated?

Review the live pricing for your account before generating. Final task cost and your account statement determine the charge. Each request is billed per video clip, not per second.

Can I keep the results from Muse Video?

Download or archive the delivered files if you need to keep them. If expires_at is returned, save them before that time; an expired link should not trigger another paid generation automatically.