wan-video

Wan 视频生成

通过 AceDataCloud 的 Wan（Alibaba）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	图像转视频（快速）	快速生成图像转视频
wan3.0-video	一体化	文本、帧、参考媒体、文件和公共链接

工作流

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. 图像转视频（Flash）

以更低延迟快速生成图像转视频。

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	image2video 时必填	字符串	源图像 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

注意事项

• wan2.6-i2v 和 wan2.6-i2v-flash 模型必须提供 image_url
• 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 服务

Wan 3 一体化

wan3.0-video 会根据 media 推断工作流。支持的类型包括 first_frame、last_frame、reference_image（最多 10 个）、reference_video（最多 5 个，总时长 15 秒）、reference_audio（最多 5 个，总时长 15 秒）、file 和 link。帧模式不能与参考/文件/链接模式混用。

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 支持 2–30 秒或 -1 自动时长。使用现有的 /wan/tasks 端点轮询。