用于视频生成的 Wan 3.0 API

通过独立的 GoEnhance 开放 API 访问 Wan 3.0,进行文本生成视频、首帧生成及首尾帧生成。提交异步请求,保存返回的 img_uuid,然后进行轮询或接收回调,直至任务成功或失败。
获取 API 密钥
代表 Wan 3.0 视频生成的电影级动态场景

选择正确的 Wan 3.0 API 请求模式

提示词与帧引导生成

向 https://api.goenhance.ai/api/v1/videos/generations 发送 POST 请求,并设置 model: wan-3-0。可以使用纯提示词,添加 image_url 作为首帧,或同时添加 image_end_url 作为末帧。
展示提示词驱动视频的随风飘动的电影级景观

用于参考资料的独立路由

使用 model: wan-3-0-refs 处理有序的参考图像、视频、音频、文档或网页。请勿将参考资料与首帧或末帧输入混合使用;这些模式是互斥的。
代表参考驱动生成的氛围感电影场景
在任务进入视频流水线之前,请验证文档中列出的字段。

Wan 3.0 API 功能与请求字段

必需的模型和提示词

对于标准路由,请将 model 设置为 wan-3-0 并提供文本 prompt。

首帧与末帧

添加 image_url 作为首帧。image_end_url 为可选参数,但必须与 image_url 一起使用。

宽高比

选择自适应、16:9、4:3、1:1、3:4 或 9:16。文档默认值为自适应;未列出 21:9。

时长

选择 2 到 30 秒之间的任意整数。文档默认值为 5 秒。

分辨率与音频

选择 480p、720p 或 1080p;GoEnhance 默认为 720p。generate_audio 默认为 true,且不收取额外生成费用。

种子与回调

可选择设置 0 到 2147483647 之间的种子,并提供用于状态更新的公共 HTTPS custom_callback_url。
两条 Wan 3.0 路由均使用相同的每秒费率。预估成本计算方式为:所选费率乘以请求时长。

Wan 3.0 API 定价

480p 定价

每生成一秒消耗 2.91 个代币,按文档中每代币 $0.02 的费率计算,即每秒 $0.0582。

720p 定价

每生成一秒消耗 5.82 个代币,按文档中每代币 $0.02 的费率计算,即每秒 $0.1164。

1080p 定价

每生成一秒消耗 11.64 个代币,按文档中每代币 $0.02 的费率计算,即每秒 $0.2328。

通过六个步骤集成 Wan 3.0 API

1

1. 创建 API 密钥

创建一个 GoEnhance 密钥,并将其作为承载令牌(bearer token)放入 Authorization 请求头中。
2

2. 选择一种输入模式

使用 wan-3-0 处理提示词或首帧/末帧,或使用 wan-3-0-refs 处理参考资料。
3

3. 验证请求

在提交前检查必填字段、帧依赖关系、时长、分辨率、比例和参考限制。
4

4. 提交任务

向 /api/v1/videos/generations 发送 POST 请求,并持久化保存返回的 img_uuid。
5

5. 跟踪状态

轮询 GET /api/v1/jobs/detail 或通过公共 HTTPS 回调 URL 接收更新。
6

6. 处理完成

以幂等方式处理成功和失败结果,验证返回的资产,并在上游参考任务失败时核算退还的令牌。
获取 API 密钥
围绕明确的输入和终端任务状态构建可重复的视频生成工作流。

Wan 3.0 API 的开发者用例

营销视频变体

根据结构化提示词生成短概念片段,用于创意评审和后续剪辑。

产品动态

在您的应用程序控制提示词、构图和完成处理的同时,为已批准的首帧添加动画效果。

故事板转场

提供首帧和末帧,以探索两个已批准视觉节点之间的动态效果。

参考驱动的创意

当工作流依赖于有序的图像、视频、音频、文档或网页时,请使用独立的参考路由。

本地化内容流水线

为区域变体设置提示词参数,而无需更改异步任务处理器。

预可视化

在全面制作前,将简洁的镜头描述转化为可评审的动态概念。
关于定价、请求模式、验证、任务状态和阿里巴巴 API 常见问题的解答。

Wan 3.0 API 常见问题解答

GoEnhance 上的 Wan 3.0 API 端点是什么?

将请求提交至 POST https://api.goenhance.ai/api/v1/videos/generations。使用 model: wan-3-0 进行提示词或首帧/末帧生成,使用 wan-3-0-refs 处理参考资料。

Wan 3.0 API 定价是如何运作的?

定价按生成秒数计算:480p 为 2.91 令牌/秒($0.0582/秒),720p 为 5.82 令牌/秒($0.1164/秒),1080p 为 11.64 令牌/秒($0.2328/秒)。将所选费率乘以时长即可。

我可以将首帧输入与参考资料混合使用吗?

不可以。两种 Wan 3.0 模式是互斥的。请将 wan-3-0 与 image_url 及可选的 image_end_url 配合使用,或将 wan-3-0-refs 与参考输入配合使用。

支持哪些时长和分辨率值?

时长接受 2 到 30 秒之间的任何整数,默认为 5 秒。分辨率接受 480p、720p 或 1080p,在 GoEnhance 上默认为 720p。

参考路由可以接受什么?

参考路径最多支持 10 张图片、5 个视频、5 个音频文件,或一个文档或公共网页。至少需要一个参考输入,且文档和网页输入互斥。

是否有组合参考视频的限制?

是的。参考视频总时长最多为 15 秒,且其组合时长加上请求的输出时长不得超过 30 秒。提交后的上游故障将根据当前的 GoEnhance 文档退还代币。

我如何知道任务何时完成?

保留 img_uuid 并轮询 GET /api/v1/jobs/detail,或者提供一个公共 HTTPS custom_callback_url。非 200 的回调响应最多会重试三次。

这是阿里巴巴官方的 Wan API 吗?

不是。Wan 与阿里巴巴相关。本页面描述的是通过 GoEnhance 进行的独立第三方访问,并不暗示关联、合作、背书,也不代表 GoEnhance 开发了 Wan 3.0。

开始使用 Wan 3.0 API 进行构建