Wan 视频生成
通过 AceDataCloud 的 Wan(阿里巴巴)API 生成 AI 视频。
设置: 请参阅 身份验证 了解令牌设置。
快速开始
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"}'
异步: 请参阅 异步任务轮询。通过
POST /wan/tasks并携带{"id": "..."}进行轮询。
模型
| 模型 | 类型 | 最佳用途 |
|---|---|---|
wan2.6-t2v | 文本转视频 | 根据文本描述创建视频 |
wan2.6-i2v | 图像转视频 | 将静态图像动画化为视频 |
wan2.6-r2v | 参考视频转视频 | 从参考视频中提取角色并迁移 |
wan2.6-i2v-flash | 图像转视频(快速) | 快速生成图像转视频 |
工作流
1. 文本转视频
POST /wan/videos
{
"action": "text2video",
"prompt": "a time-lapse of flowers blooming in a meadow",
"model": "wan2.6-t2v",
"resolution": "720P",
"duration": 5
}
2. 图像转视频
将静态图像动画化为视频片段。
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. 图像转视频(快速版)
更快的图像转视频生成,降低延迟。
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. 参考视频迁移
从参考视频中提取角色或音色,并将其迁移到新的生成中。
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. 多镜头编辑
生成包含多个镜头的视频,而不是单个连续镜头。
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. 带音频的视频
在生成视频的同时启用音频生成。
POST /wan/videos
{
"action": "text2video",
"prompt": "ocean waves crashing on a rocky shore",
"model": "wan2.6-t2v",
"audio": true
}
参数
| 参数 | 是否必须 | 值 | 描述 |
|---|---|---|---|
action | 是 | "text2video", "image2video" | 操作类型 |
prompt | 是 | 字符串 | 场景描述 |
model | 是 | "wan2.6-t2v", "wan2.6-i2v", "wan2.6-r2v", "wan2.6-i2v-flash" | 模型 |
image_url | 图像转视频必填 | 字符串 | 源图像 URL(图像转视频必需) |
negative_prompt | 否 | 字符串(最多 500 字符) | 要排除在生成之外的内容 |
reference_video_urls | r2v 必填 | 字符串数组 | 用于角色/音色提取的参考视频 |
shot_type | 否 | "single", "multi" | 连续镜头或多镜头编辑 |
audio | 否 | 布尔值 | 在生成的视频中启用音频 |
audio_url | 否 | 字符串 | 参考音频 URL |
resolution | 否 | "480P", "720P", "1080P" | 输出分辨率(默认:720P) |
size | 否 | 字符串 | 生成的视频尺寸 |
duration | 否 | 5, 10, 15 | 视频时长(秒) |
prompt_extend | 否 | 布尔值 | 启用基于 LLM 的提示重写 |
callback_url | 否 | 字符串 | 异步 webhook 通知 URL |
注意事项
image_url对于wan2.6-i2v和wan2.6-i2v-flash模型是必需的reference_video_urls仅与wan2.6-r2v一起使用,用于角色/音色迁移negative_prompt的最大长度为 500 字符- 支持的时长仅为 5、10 或 15 秒
- 默认分辨率为 720P;使用 1080P 可获得更高画质,但成本增加
shot_type: "multi"生成多镜头编辑,而非单个连续镜头
MCP:
pip install mcp-wan| 托管地址:https://wan.mcp.acedata.cloud/mcp| 查看 所有 MCP 服务器