Wan API

八个视频模型，一把 API Key

Wan 3.0、Wan 3.0 Prime、Wan 3.0 Pro、Wan 3.0 Prime Pro 四个 Wan 变体，与 Seedance 2.5、Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini 并列在同一平台。GET /v1/models 会列出当前 Key 可访问的模型，每个模型都有各自的文档化 ID，例如 wan3.0-video 与 w3.0-video-prime-pro。

多模态输入方式

生成请求可只写文本提示词，可给首帧或尾帧，也可提供参考素材：最多 10 张图、5 段视频、5 段音频，此外还支持一份文档或一个公开网页链接。关键帧模式与参考模式互斥，不能在同一个请求里混用；提示词长度上限为 20,000 字符。

带原生请求预览的 Playground

每个模型页面都内嵌 Playground，按所选模型拼装扁平的原生请求体，留空的可选字段不会写入，提交前还会检查该模型的可用性。Playground 使用网页会话与同一份预充值余额，因此无需把 Key 粘贴到浏览器里。

异步任务接口

向模型端点提交后会立刻返回公开任务 ID；轮询状态为 pending、processing、completed 或 failed，完成时响应中带一个签名的 Bunny CDN 链接，直接播放或下载都不需要 Authorization 头。POST /v1/responses 则支持同步等待、后台模式以及 server-sent events 三种返回方式。

用内容审核档位控制单价

可选字段 nsfw_checker 在 Wan 3.0 与 Wan 3.0 Prime 上切换严格或较宽松的审核，两档各有自己的每秒单价。Pro 变体只接受 false。被审核明确拒绝的提交，可以在保持同一公开模型 ID 的前提下改用另一档重试。

余额查询与任务清理接口

GET /v1/balance 返回账户可消费余额以及该 Key 的剩余额度；DELETE /v1/tasks/{task_id} 删除一个已结束的任务及其存储的视频与尾帧文件。站点正文还以 /llms.txt 和 /llms-full.txt 形式提供给程序读取。

• 电商与产品团队：把一张产品静态照变成缓慢环绕或推近的镜头，再检查外形、反光与标签是否仍然准确，之后才投放到 campaign。
• 编剧、分镜与社媒剪辑：在没有实拍和关键原画时先把文字场景变成动态预览，用短片判断光线、镜头方向与节奏，再决定是否加长成片。
• 按 brief 工作的代理公司：输入一份简短文档或公开网页，让书面创意变成面向目标人群、承载单一信息的视觉起点。
• 做视频集成的工程团队：并排比较 Wan 与 Seedance 的单价、时长与参考素材配额，选定后仍复用同一把 Key 和同一份余额。
• 靠参考素材做角色的创作：给每张上传素材指定作用——外观、运动、声音——让 Seedance 2.5 的较长场景保持角色与场景可辨。

这是阿里巴巴或 ByteDance 的官方服务吗？

不是。Wan API 在 wanapi.app 独立运营，与 Alibaba、Wan 或 ByteDance 无隶属也无背书关系；这些名称只用于指代平台接入的第三方模型，商标归各自所有者。

需要订阅才能生成视频吗？

页面未列出任何月度视频套餐。能否生成取决于账户是否启用且美元余额充足，每次生成的费用是该分辨率单价乘以计费秒数。

哪些秒数会被计费？

参考视频输入秒数加生成输出秒数。文本、图像与音频输入不增加秒数，关闭生成音频也不会降低单价。

任务可以取消或自动重试吗？

平台未公布取消、webhook 或幂等键约定，提交也不会自动重试或改用其他模型。超时或没拿到任务 ID 时应先查询已有任务，再次 POST 可能产生第二个付费任务。

生成的视频会保留多久？

完成的任务返回无需 Key 的签名 CDN 链接，文件遵循平台既有的存储保留策略。查询任务不会延长可访问期限，需要保留请自行转存。

第一次测试该选哪个模型？

Wan 3.0 覆盖 480p 到 1080p，价格最低；Prime 是独立模型、定价不同；只有 Pro 变体提供 2K 与 4K。Seedance 各页另有自己的时长与参考配额，应按交付要求匹配，不要假设更便宜的模型也有更高分辨率。

同一个请求体可以在各模型间复用吗？

四个 Wan 模型共享 14 个原生生成字段，但分辨率取值、模型 ID 与 nsfw_checker 支持情况不同——Pro 变体只接受较宽松那一档。未知字段会被拒绝，复用前请先查目标模型页面。

• 用 Google 登录 wanapi.app，进入账户设置充值，因为只注册网站账户并不能生成视频。
• 在 API Key 设置中创建 Key 并仅保存在服务端；Playground 走网页会话和同一份余额，不需要提供 Key。
• 从模型总览或 GET /v1/models 选定模型，再读该模型页面确认可用分辨率、时长区间与参考素材上限。
• 在该模型的 Playground 里起草请求并复制预览出的原生请求体，或按文档化的模型 ID 手写 JSON。
• 提交请求，立刻保存返回的任务 ID，并从 5 秒间隔开始轮询，遇到临时错误再逐步拉长间隔。
• 用完成响应里的签名 URL 播放或下载，并在保留期结束前把文件转存到自己的存储。