Skip to main content
POST
Create a Wan 3.0 Prime (special-price) video asynchronously. Use POST /v1/videos with a billing key: wan3.0-prime-720p or wan3.0-prime-1080p. On success you get a task_id. Poll Query video task and read result.video_url when the task completes.

Models

Billing is per_second. Cost = unit price for that resolution × requested duration. Live unit prices come from the model catalog and the cost field in responses. model: "wan3.0-prime" is also accepted. Set resolution to pick the tier (default 1080p). The task model is stored as the billing key.

Modes

This API does not support first/last-frame fields.

Reference limits

Reference media must be publicly reachable URLs.

Request fields

Examples

Text-to-video

1080p with a reference image

Response

Create returns the shared task payload (task_id, status, cost, …). data.model is the billing key (for example wan3.0-prime-720p). Poll the query endpoint for result.video_url.

Authorizations

Authorization
string
header
required

控制台创建的 API Key,格式:Bearer sk_xxx

Body

application/json
model
string
required

omni-10s, veo3.1-fast, veo3.1-lite, veo3.1-lite-hd, grok-imagine-video-1.5 (and fast/lite), minimax-h3, minimax-h3-max, kling-4.0 / kling-4.0-720p / kling-4.0-1080p, sd2.5-480p / sd2.5-720p / sd2.5-1080p, seedance2.0-md, sd2-480p-ac, sd2-720p-ac, sd2-720p-dl, sd2-720p-db, sd2.0-mini-720p, seedance2.5-30s, sd2.5-720p-ac, sd2.5-720p-933-ac, wan3-720p / wan3-1080p, wan3.0-prime-720p / wan3.0-prime-1080p, wan3-480p-20s-ac, or muse-video / muse-video-20s / muse-video-30s / muse-video-40s / muse-video-50s / muse-video-60s

Example:

"omni-10s"

prompt
string
required
duration

omni-10s: fixed 10; seedance2.0-md: 5/10/15; sd2-*-ac: 4–15; sd2-720p-dl: fixed 15; sd2-720p-db: 5/10/15; sd2.0-mini-720p: 4–15; sd2.5-480p / sd2.5-720p / sd2.5-1080p: 5–30; seedance2.5-30s: fixed 30; sd2.5-720p-ac and sd2.5-720p-933-ac: 4–30; wan3-720p / wan3-1080p: 10–30; wan3.0-prime-720p: 10–30; wan3.0-prime-1080p: 8–30; wan3-480p-20s-ac: 5–20; Muse Video: 1–60, billed as muse-video (1–10, default 5s when omitted) or muse-video-20s through muse-video-60s

seconds

Alias of duration

aspect_ratio
string
ratio
string

Alias of aspect_ratio

orientation
string

portrait/landscape may imply aspect ratio

size
string
resolution
string

omni-10s is fixed at 720p. Muse Video supports 720p only

first_image
string<uri>

First-frame URL. Used by omni-10s and Muse Video

last_image
string<uri>

Last-frame URL; use with first_image. Muse Video also requires a first frame

images
string<uri>[]
reference_images
string<uri>[]
videos
string<uri>[]
reference_videos
string<uri>[]
reference_video_durations
integer[]

Required with reference videos for kling-4.0; same length as videos; seconds 1–30. Billable seconds = output duration + sum of these values.

Required range: 1 <= x <= 30
reference_audio_durations
integer[]

Required with reference audios for kling-4.0; same length as audios; seconds 5–30 (validation only, not billed).

Required range: 5 <= x <= 30
audios
string<uri>[]
reference_audios
string<uri>[]
first_image_url
string<uri>

Alias of first_image. Accepted by Muse Video

last_image_url
string<uri>

Alias of last_image. Muse Video requires a first frame as well

image_urls
string<uri>[]

Reference image URLs. Muse Video: frames plus references, up to 10 on the 10s tier and 9 on the 20–60s tiers

reference_image_urls
string<uri>[]

Alias of images

camera_movement
string

Muse Video camera move, free text, up to 1000 characters

style
string

Muse Video style, free text, up to 1000 characters

negative_prompt
string

Muse Video negative prompt, separate from prompt, up to 1000 characters

smart_queue
boolean
default:false

When true, a very low recent success rate keeps the task queued until recovery (up to about 2 hours)

Response

200 - application/json

Submitted

code
integer
Example:

20000

msg
string
data
object
Last modified on November 14, 2026