Wan 3.0 Prime API

Generate video from a prompt for up to 30 seconds with optional audio.

Wan 3.0 Prime modes

Alibaba · wan-3.0-prime-text-to-video

Text to video

Generate video from a prompt for up to 30 seconds with optional audio.

Put a prompt and "model": "wan-3.0-prime-text-to-video" on a video clip, and the render generates it and edits it into the video. To generate it on its own, send the same asset to the generate endpoint.

Built for1080p clips with sound · Scenes for explainers and ads · Repeatable variations

Wan 3.0 Prime “Seen from above, morning sunlight slides across a green desk and steam curls up from a cup”
Technical specifications
InputText prompt
OutputVideo
Length2 to 30 seconds
Resolution480p, 720p, 1080p
Aspect ratiosadaptive, 16:9, 4:3, 1:1, 3:4, 9:16
AudioGenerated, can be turned off
SeedSet a seed for repeatable results
Prompt enhancementOn by default, can be turned off
{
  "asset": {
    "type": "video",
    "prompt": "Seen from above, morning sunlight slides across a green desk and steam curls up from a cup",
    "model": "wan-3.0-prime-text-to-video",
    "options": {
      "aspectRatio": "4:3"
    }
  },
  "length": 5
}
Example request to the generate endpoint.

Options

OptionValuesDefault
aspectRatioadaptive, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
resolution480p, 720p, 1080p1080p
generateAudiobooleantrue
enhancePromptbooleantrue
seedinteger from 0 to 2147483647

Alibaba · wan-3.0-prime-image-to-video

Image to video

Animate an image for up to 30 seconds with optional audio.

Put a prompt and "model": "wan-3.0-prime-image-to-video" on a video clip, and the render generates it and edits it into the video. To generate it on its own, send the same asset to the generate endpoint.

Built forAnimating product photos · Motion for listings and ads · Repeatable variations

The image the example starts from
Start image
Wan 3.0 Prime “A breeze lifts the shirt's hem and sleeves, which sway and slowly settle, as the camera pushes in”
Technical specifications
InputText prompt and a start image, with an optional end image
OutputVideo
Length2 to 30 seconds
Resolution480p, 720p, 1080p
Aspect ratiosadaptive, 16:9, 4:3, 1:1, 3:4, 9:16
AudioGenerated, can be turned off
SeedSet a seed for repeatable results
Prompt enhancementOn by default, can be turned off
{
  "asset": {
    "type": "video",
    "prompt": "A breeze lifts the shirt's hem and sleeves, which sway and slowly settle, as the camera pushes in",
    "model": "wan-3.0-prime-image-to-video",
    "options": {
      "startSrc": "https://shotstack.io/assets/generated/linen-shirt-4x3.webp",
      "aspectRatio": "4:3"
    }
  },
  "length": 5
}
Example request to the generate endpoint.

Options

OptionValuesDefault
startSrc (required)string
endSrcstring
aspectRatioadaptive, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
resolution480p, 720p, 1080p1080p
generateAudiobooleantrue
enhancePromptbooleantrue
seedinteger from 0 to 2147483647

Pricing

Generation is paid in credits from the same balance as rendering, at what the model's provider charges plus a small margin. See AI generation pricing.

ModeCharged perPrice changes withLength a quote assumes without one
Text to videoSecond of video, 2 to 30Resolution: 480p, 720p, 1080p (default)5 seconds
Image to videoSecond of video, 2 to 30Resolution: 480p, 720p, 1080p (default)5 seconds

Get a quote

POST /generate/quote takes the same body as the generate endpoint and returns what that generation would cost. Nothing is generated, reserved or charged.

curl -X POST \
     -H "Content-Type: application/json" \
     -H "x-api-key: $SHOTSTACK_API_KEY" \
     -d '{
       "asset": {
         "type": "video",
         "prompt": "Seen from above, morning sunlight slides across a green desk and steam curls up from a cup",
         "model": "wan-3.0-prime-text-to-video",
         "options": {
           "aspectRatio": "4:3"
         }
       },
       "length": 5
     }' \
     https://api.shotstack.io/edit/stage/generate/quote

The response gives credits, the price of that request, and ceiling, which is true when the request has no length for a model charged by length, so the price is an estimate. Prices follow the providers, so ask again rather than storing one.

How it compares

Wan 3.0 Prime beside the other models in Shotstack that make the same thing.

ModelBest forModesLengthMax resolutionAspect ratiosAudioEnd imageSeed
Wan 3.0 Prime1080p clips, with audio and prompt enhancement on by defaultText to video, Image to video2–30 s1080p5On by defaultYesYes
Seedance 2.0Cinematic motion and prompt-directed camera movesText to video, Image to video4–15 s1080p6OptionalYes—
Seedance 2.5Longer scenes, up to 30 seconds in one clipText to video, Image to video4–30 s1080p6OptionalYes—
Gemini Omni Flash 1.1Short clips up to 4K, with native audioText to video, Image to video3–10 s4K2NativeYes—

Questions

Do I need an account with the model provider?
No. Generation runs on your Shotstack API key and is paid in credits from the same balance as rendering, so there is no separate account to open and nothing extra to integrate.
Do I pay again for the same asset?
No. Every generated file is stored against your account. An asset with the same type, model, prompt, options and length as one generated before reuses the stored file at no charge.
What happens if a generation fails?
A failed generation isn't charged. If a render fails after some of its assets were generated, those assets are kept, and rendering again reuses them at no charge.
Can I generate an asset without rendering a video?
Yes. POST the asset to the generate endpoint and you get back a URL to the file, to check it before you render, to reuse it across many edits, or to use it outside Shotstack.

Start free

  • 10 free credits to start
  • No credit card required