wan-video

# Wan Video Generation Generate AI videos through AceDataCloud's Wan (Alibaba) API. > **Setup:** See [authentication](../_shared/authentication.md) for token setup. ## Quick Start ```bash curl -X POST https://api.acedata.cloud/wan/videos \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"action": "text2video", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "wan2.6-t2v"}' ``` > **Async:** See [async task polling](../_shared/async-tasks.md). Poll via `POST /wan/tasks` with `{"id": "..."}`. ## Models | Model | Type | Best For | |-------|------|----------| | `wan2.6-t2v` | Text-to-Video | Creating video from text description | | `wan2.6-i2v` | Image-to-Video | Animating a still image into video | | `wan2.6-r2v` | Reference Video-to-Video | Character extraction and transfer from reference video | | `wan2.6-i2v-flash` | Image-to-Video (Fast) | Quick image-to-video generation | | `wan3.0-video` | All-in-One | Text, frames, reference media, files, and public links | ## Workflows ### 1. Text-to-Video ```json POST /wan/videos { "action": "text2video", "prompt": "a time-lapse of flowers blooming in a meadow", "model": "wan2.6-t2v", "resolution": "720P", "duration": 5 } ``` ### 2. Image-to-Video Animate a still image into a video clip. ```json POST /wan/videos { "action": "image2video", "prompt": "gentle wind blows through the scene", "model": "wan2.6-i2v", "image_url": "https://example.com/landscape.jpg", "resolution": "720P", "duration": 5 } ``` ### 3. Image-to-Video (Flash) Faster image-to-video generation with reduced latency. ```json POST /wan/videos { "action": "image2video", "prompt": "camera slowly pans across the landscape", "model": "wan2.6-i2v-flash", "image_url": "https://example.com/scene.jpg" } ``` ### 4. Reference Video Transfer Extract characters or timbres from a reference video and transfer them into a new generation. ```json POST /wan/videos { "action": "text2video", "prompt": "the character walks through a futuristic city at night", "model": "wan2.6-r2v", "reference_video_urls": ["https://example.com/reference.mp4"] } ``` ### 5. Multi-Cut Editing Generate a video with multiple shots rather than a single continuous take. ```json POST /wan/videos { "action": "text2video", "prompt": "a chef preparing a meal in a busy kitchen", "model": "wan2.6-t2v", "shot_type": "multi", "duration": 10 } ``` ### 6. Video with Audio Enable audio generation alongside the video. ```json POST /wan/videos { "action": "text2video", "prompt": "ocean waves crashing on a rocky shore", "model": "wan2.6-t2v", "audio": true } ``` ## Parameters | Parameter | Required | Values | Description | |-----------|----------|--------|-------------| | `action` | Yes | `"text2video"`, `"image2video"` | Action type | | `prompt` | Yes | string | Scene description | | `model` | Yes | `"wan2.6-t2v"`, `"wan2.6-i2v"`, `"wan2.6-r2v"`, `"wan2.6-i2v-flash"` | Model | | `image_url` | For image2video | string | Source image URL (required for image-to-video) | | `negative_prompt` | No | string (max 500 chars) | Content to exclude from generation | | `reference_video_urls` | For r2v | array of strings | Reference videos for character/timbre extraction | | `shot_type` | No | `"single"`, `"multi"` | Continuous shot or multi-cut editing | | `audio` | No | boolean | Enable audio in the generated video | | `audio_url` | No | string | Reference audio URL | | `resolution` | No | `"480P"`, `"720P"`, `"1080P"` | Output resolution (default: 720P) | | `size` | No | string | The size of the generated video | | `duration` | No | `5`, `10`, `15` | Video duration in seconds | | `prompt_extend` | No | boolean | Enable LLM-based prompt rewriting | | `callback_url` | No | string | Async webhook notification URL | ## Gotchas - `image_url` is **required** for `wan2.6-i2v` and `wan2.6-i2v-flash` models - `reference_video_urls` is used only with `wan2.6-r2v` for character/timbre transfer - `negative_prompt` has a maximum length of 500 characters - Supported durations are 5, 10, or 15 seconds only - Default resolution is 720P; use 1080P for higher quality at increased cost - `shot_type: "multi"` produces multi-cut edits rather than a single continuous shot > **MCP:** `pip install mcp-wan` | Hosted: `https://wan.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md) ## Wan 3 All-in-One `wan3.0-video` infers the workflow from `media`. Supported types are `first_frame`, `last_frame`, `reference_image` (up to 10), `reference_video` (up to 5, 15 seconds total), `reference_audio` (up to 5, 15 seconds total), `file`, and `link`. Frame mode cannot be mixed with reference/file/link mode. ```json POST /wan/videos { "model": "wan3.0-video", "prompt": "Use image 1 to create a cinematic product video", "media": [{"type":"reference_image","url":"https://cdn.acedata.cloud/r9vsv9.png"}], "resolution": "720P", "ratio": "16:9", "duration": 5, "audio": true, "async": true } ``` Wan 3 supports 2–30 seconds or `-1` automatic duration. Poll with the existing `/wan/tasks` endpoint.