SKILL.md
Wan Video Generation
Generate AI videos through AceDataCloud's Wan (Alibaba) API.
Setup: See [authentication](../_shared/authentication.md) for token setup.
Quick Start
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/taskswith{"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
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.
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.
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.
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.
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.
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 |
referencevideourls |
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_urlis required forwan2.6-i2vandwan2.6-i2v-flashmodelsreferencevideourlsis used only withwan2.6-r2vfor character/timbre transfernegative_prompthas 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 firstframe, lastframe, referenceimage (up to 10), referencevideo (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.
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.