Video models
Wan 3.0 Video
On this page
Wan 3.0 Video — high-quality AI video generation.
| modelId | wan-3-0-video |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Default | wan-3-0-video | POST /api/v1/generate | first_frame_url, prompt, aspect_ratio |
| Poll task | — | GET /api/v1/task/{id}?model=wan-3-0-video | — |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| first_frame_url | string | Yes | Image URL |
| last_frame_url | string | No | Image URL |
| prompt | string | Yes | Text prompt used to describe the desired video content. Supports both Chinese and English, with a maximum length of 20,000 characters. Max 20000 characters. (example: Create a **15-second photorealistic cinematic sci-fi action sequence** A young Asian female courier in a black futuristic riding suit with subtle red details… — full value in the request example) |
| reference_image_urls | string[] | No | Maximum 10 images. Mapped in array order to Image1, Image2, ... in the prompt. Specifications are the same as first_frame_url. Cannot be used together with first frame / last frame. (image URL) |
| reference_video_urls | string[] | No | Maximum 5 clips. Each clip: 1–15s; total combined duration ≤ 15s. Mapped in array order to Video1, Video2, ... in the prompt. Formats: mp4, mov. Single side: [240, 4096] px; aspect ratio ≤ 8:1; file size per clip ≤ 100MB. Additionally, on the output side: total input video duration + output duration (duration parameter) must not exceed 30 seconds. (image URL) |
| reference_audio_urls | string[] | No | Maximum 5 clips. Each clip: 1–15s; total combined duration ≤ 15s. Mapped in array order to Audio1, Audio2, ... in the prompt. Formats: wav, mp3; file size ≤ 15MB per clip. When not used as the sole media input, it is still recommended to pair with images or videos. (image URL) |
| reference_link_urls | string | No | Maximum 1 publicly accessible webpage (no login required). Cannot be used together with reference_file_urls, nor with first frame / last frame. |
| reference_file_urls | string | No | Maximum 1 file. Cannot be used together with reference_link_urls, nor with first frame / last frame. Supported formats: docx, doc, xlsx, xls, pptx, ppt, pdf, txt, key, pages, numbers, md. File size ≤ 100MB. For file types such as pdf, docx, ppt, key, pages, etc., page count ≤ 50 pages. |
| resolution | string | No | Preset resolution levels for video generation. (options: 480P | 720P | 1080P) (default: 1080P) |
| aspect_ratio | string | Yes | Aspect ratio for generated video. "Adaptive" auto-recommends a ratio based on input media proportions and intent. (options: adaptive | 16:9 | 4:3 | 1:1 | 3:4 | 9:16) (default: 16:9) |
| duration | number | No | Duration of the generated video, in seconds (2-30). With a reference video attached, the input video duration plus this duration must not exceed 30 seconds. (range 2-30) (default: 5) |
| audio | boolean | No | Whether the output video includes audio. true (default): Includes audio; false: No audio track. (true/false) (default: true) |
Example request
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"wan-3-0-video","input":{"prompt":"Create a **15-second photorealistic cinematic sci-fi action sequence**\n\nA young Asian female courier in a black futuristic riding suit with subtle red details rides a distinctive **red electric superbike** through a neon city at night. A small silver delivery case is securely attached behind her.\n\nKeep the woman, motorcycle, clothing, and silver case visually identical throughout.\n\n### 0–3s — SCROLL-STOP HOOK\n\nExtreme low-angle tracking shot beside the red motorcycle racing through a rain-soaked neon street.\n\nThe front tire cuts through a large puddle, sending a dramatic wall of water across the frame.\n\nCamera rises smoothly beside the rider as she accelerates.\n\nNeon reflections streak across the glossy red bike.\n\nDeep electric motor sound, rain, tire spray, and distant sirens.\n\n### 3–7s — PURSUIT\n\nTwo black security drones descend behind her and begin chasing.\n\nA red targeting beam sweeps across the road.\n\nOne drone fires an energy projectile.\n\nThe rider notices the warning reflection in her side mirror, shifts her body, and leans naturally into a hard turn.\n\nThe projectile misses and explodes against a roadside barrier behind her.\n\nThe shockwave arrives a moment later, pushing smoke and loose debris outward.\n\nMotorcycle tires remain firmly connected to the road with believable grip, suspension, weight, and momentum.\n\n### 7–11s — COLLAPSING CITY\n\nThe motorcycle races onto an elevated highway.\n\nAhead, part of a futuristic tower begins collapsing onto the road.\n\nShe briefly brakes, identifies a narrow opening between falling debris, then accelerates toward it.\n\nCamera tracks closely beside her as steel and glass crash down around the motorcycle.\n\nDebris falls under gravity with clear weight and momentum.\n\nShe clears the collapsing section at the last possible moment.\n\n### 11–15s — EPIC PAYOFF\n\nThe red motorcycle launches out of the smoke onto an open section of highway.\n\nA pursuing drone emerges behind her.\n\nShe presses a control on the handlebar.\n\nA defensive energy pulse fires backward and strikes the drone.\n\nHuge explosion.\n\nThe motorcycle continues racing toward camera while the fireball expands behind her.\n\nCamera swings into a dramatic front three-quarter hero angle.\n\nRain, orange fire, cyan neon, smoke, and red bodywork create a striking final composition.\n\nThe silver case remains securely attached.\n\nShe accelerates into the darkness as the burning drone crashes behind her.\n\nCut to black.\n\n**STYLE**\nPremium theatrical sci-fi action, photorealistic live action, red motorcycle against cyan neon and orange explosions, realistic rain, wet reflections, volumetric smoke, detailed destruction, cinematic contrast, high-end blockbuster quality.\n\n**CAMERA**\nLow beauty tracking → side pursuit → close obstacle tracking → front hero escape.\n\nFast but readable movement. Clear spatial continuity. No impossible camera transitions.\n\n**PHYSICS**\nEvery action must have cause and effect: detection → steering reaction → vehicle response → impact → delayed debris or shockwave.\n\nRealistic tire grip, suspension, acceleration, braking, gravity, collisions, and falling debris.\n\n**AUDIO**\nSynchronized electric motor, rain, tire spray, drone engines, energy shots, explosion, falling debris, alarms, and cinematic action score.\n\n**AVOID**\nFloating vehicles, impossible drifting, teleporting drones, changing motorcycle design, weightless debris, random explosions, chaotic camera movement, subtitles, text, logos, watermark.","resolution":"720P","aspect_ratio":"16:9","duration":5,"audio":true}}'