Skip to content

Mage API · Video model

Wan 3.0 API

Wan 3.0, with a strict filter

POST https://api.mage.space/v1/wan_3/generate

At a glance

The Wan 3.0 API runs Wan 3.0 through Mage at POST https://api.mage.space/v1/wan_3/generate. A request at the default settings costs 245 Gems (about $0.245), with no subscription. Wan 3.0 takes saved characters, references, audio references by @handle in the prompt.

  • VideoOutput
  • 1Variant
  • 245Gems per clip, default
  • $0.245About, in USD

Overview

What the Wan 3.0 API does

Alibaba's all-in-one Wan 3.0. Start and end frames, up to 10 references or Characters, Voices and audio, and clips from 2 to 30 seconds at up to 1080p. Strict Filter: the provider's content filter applies.

Alibaba's Wan 3.0, one video model for text, frames, reference images, reference videos, and Voices, in clips from 2 to 30 seconds with generated audio. Strict Filter: the provider's content filter checks the prompt, the input media, and the finished video; a request it refuses fails with `content_blocked` and a reason, and is refunded.

It accepts first_image, last_image, image, additional_images, videos as inputs.

Quick start

Call the Wan 3.0 API

Set MAGE_API_KEY, submit to /wan_3/generate, and poll status_url until the request completes.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/wan_3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "wan-3.0"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('wan_3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'wan-3.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("wan_3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "wan-3.0",
})

print(request["result"]["url"])

Models

Wan 3.0 model_id values

Send model_id to pick a variant. A request without one runs the default.

model_idNameDefault
wan-3.0Wan 3.0Yes

Options

Wan 3.0 parameters

Allowed values across all variants; a variant may offer fewer. The docs list the options per variant.

FieldValues
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

Inputs

Media inputs Wan 3.0 accepts

Send each as an https URL, a data URL, or an upload of up to 100 MB.

FieldRole
first_imageThe first frame image.
last_imageThe last frame image.
imageThe reference image.
additional_imagesAdditional reference images.
videosThe source videos.

Rules

What the Wan 3.0 API enforces

  • First and last frames cannot be combined with reference images or videos: send one kind or the other.
  • Up to 10 reference images and 5 reference videos.
  • Each reference video is 1 to 15 seconds long, at most 15 seconds combined, and the combined length plus `duration` is at most 30 seconds. Reference-video seconds bill like output seconds.

More video models

Other video generation APIs on Mage

  • Video · from 40 Gems

    Wan Video v2.2 API

    Open-weights video with a Lightning variant

  • Video · from 189 Gems

    Berry API

    Video that stays true to your references

  • Video · from 360 Gems

    Blueberry API

    Pin the first and last frame

  • Video · from 618 Gems

    Cherry API

    Our flagship video family

  • Video · from 375 Gems

    Grok Video API

    Grok Imagine, in motion

  • Video · from 270 Gems

    Kiwi API

    Everyday video, zero setup

FAQ

Frequently asked questions

How much does the Wan 3.0 API cost?
A Wan 3.0 request at the default settings (Wan 3.0) costs 245 Gems, about $0.245. Other resolutions, durations, and variants change the price; the response reports the exact charge. A generation that fails is refunded; one Mage's content policy blocks is not.
What is the Wan 3.0 API endpoint?
POST https://api.mage.space/v1/wan_3/generate with an Authorization: Bearer header carrying your Mage API key. The response includes a status_url to poll for the result.
Which Wan 3.0 models can I call?
wan-3.0 (Wan 3.0). The default is Wan 3.0.
Does Wan 3.0 support reference images or characters?
Wan 3.0 accepts first_image, last_image, image, additional_images, videos. Wan 3.0 takes saved characters, references, audio references by @handle in the prompt.
Can I use Wan 3.0 from Claude or ChatGPT?
Yes. Connect the Mage MCP server to Claude, ChatGPT, Claude Code, Grok, or Cursor and ask for Wan 3.0 by name. Your assistant reads its options with get_model and quotes the price before it generates.
How long are Wan 3.0 results kept?
Results and inputs are kept for 30 days. Download anything you want to keep to your own storage.

Start building with Mage

One account, one Gems balance, every model. Pay only for what you generate.