一条命令完成安装
不用复制任何密钥。运行你所用 Agent 对应的命令,然后在浏览器里登录 wan3.video 并点“允许”。
codex mcp add wan3 --url https://wan3.video/mcp浏览器会立即打开。点“允许”后,启动 codex 让它生成视频即可。
claude mcp add --scope user --transport http wan3 https://wan3.video/mcp启动 Claude Code,输入 /mcp,选中 wan3 后选择 Authenticate。
grok mcp add --transport http wan3 https://wan3.video/mcp启动 grok,输入 /mcps,选中 wan3 后按 i。
使用流程
添加 wan3
命令会把服务地址 https://wan3.video/mcp 写进 Agent 的设置。
在浏览器里允许
登录 wan3.video 并点“允许”。Agent 会拿到一个以它命名的专属 API 密钥,你可以随时撤销。
用一句话要视频
描述你想要的画面。Agent 发起生成并持续查询,直到 MP4 就绪,通常几分钟内完成。
生成视频按与网站相同的价格扣积分,生成失败会自动退回积分。详见价格页面。
Agent 能做什么
共 6 个工具,执行的操作与 REST API 相同。只有 generate_video 会花费积分。
| get_account | 查看积分余额、会员状态,以及正在渲染的视频数量。 |
|---|---|
| list_models | 列出各个模型支持的分辨率、时长和每 5 秒的积分价格。 |
| generate_video | 用你的积分发起文生视频、图生视频或视频编辑。 |
| get_video | 最多等待 45 秒,渲染完成后返回下载链接。 |
| list_videos | 列出你的视频,最新的在前。 |
| create_upload | 为本地图片或视频准备上传,并返回可直接运行的 curl 命令。 |
改用 API 密钥
在 CI 任务或没有浏览器的机器上,先在 API 密钥页面 创建密钥,导出为环境变量 WAN3_API_KEY,再用它添加服务:
codex mcp add wan3 --url https://wan3.video/mcp \
--bearer-token-env-var WAN3_API_KEYclaude mcp add --scope user --transport http wan3 https://wan3.video/mcp \
--header "Authorization: Bearer $WAN3_API_KEY"grok mcp add --transport http wan3 https://wan3.video/mcp \
--header "Authorization: Bearer $WAN3_API_KEY"Codex 每次启动时从环境变量读取密钥;Claude Code 和 Grok CLI 会把展开后的密钥保存在各自的配置文件里,请像保管密钥本身一样保管这些文件。