Agent Skills
› NeverSight/learn-skills.dev
› wan-video
wan-video
GitHub通过 AceDataCloud API 调用阿里 Wan 模型生成 AI 视频。支持文生视频、图生视频、参考视频转绘及多分辨率输出，可选音频与多镜头剪辑功能。
Trigger Scenarios
根据文本描述生成视频
将静态图片动画化
基于参考视频进行角色或风格迁移
需要快速生成短视频片段
生成带有同步音频的视频内容
Install
npx skills add NeverSight/learn-skills.dev --skill wan-video -g -y
SKILL.md
Frontmatter
{
"name": "wan-video",
"license": "Apache-2.0",
"metadata": {
"author": "acedatacloud",
"version": "1.0"
},
"description": "Generate AI videos with Wan (Alibaba) via AceDataCloud API. Use when creating videos from text prompts or animating images into video. Supports text-to-video, image-to-video, reference video transfer, multi-resolution (480P-1080P), and optional audio.",
"compatibility": "Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared\/authentication.md). Optionally pair with mcp-wan for tool-use."
}
Wan Video Generation
Generate AI videos through AceDataCloud's Wan (Alibaba) API.
Setup: See authentication 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. 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 |
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 |
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_urlis required forwan2.6-i2vandwan2.6-i2v-flashmodelsreference_video_urlsis 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
Version History
- e0220ca Current 2026-07-05 22:56
