
Wan 3.0 ComfyUI 使用指南:官方模板、API 接入、账号配置与视频生成费用和输入限制说明
了解 Wan 3.0 ComfyUI 官方模板和自定义 reAPI 接入流程,区分云端生成与本地推理。本文说明账号与积分要求、公开媒体链接、请求字段、任务轮询和结果下载,并根据 2026 年 9 月 14 日核查的资料解释分辨率限制、参考视频计费及自动时长费用,帮助你选择适合现有工作流的接入方式并估算实际请求成本。
Wan 3.0 ComfyUI 工作流已经可以通过托管 API 节点使用。Comfy 官方文章提供了文生视频、图生视频和参考素材生成视频三套模板。如果你希望在现有节点图里生成视频,直接从这些模板开始,无需先下载 Wan 3.0 权重。[1]
界面在本机运行,并不意味着模型也在本机推理。2026 年 9 月 14 日检查的官方 Wan 索引没有列出可下载的 3.0 权重。使用 reAPI 时,可以自行适配 Wan 3.0 API,由自己的程序提交并跟踪任务。这与 Comfy 内置的账号和计费是两条独立路径。[2][3][4]
TL;DR
- Comfy 官方提供三套 Wan 3.0 模板,发布时要求 ComfyUI v0.33.4;找不到节点时先更新。[1]
- 官方 Partner Nodes 需要 Comfy 账号和付费积分,不能直接把凭据换成 reAPI 密钥。[5]
- Comfy 公告列出 480p、720p、1080p;reAPI 另有 2K、4K,但文档和网页输入有分辨率限制。[1][4]
- 自建 reAPI 适配层需要处理公网素材 URL、提交、轮询和下载,不需要加载本地 Wan 检查点。[4]
- 真正要在自己的 GPU 上推理,可以选择有权重的 Wan 2.2 及其原生 ComfyUI 工作流。[6]
Wan 3.0 ComfyUI 三套模板如何选择
只有文字描述时选文生视频;希望一张图片约束画面时选图生视频;需要图像、视频或音频提供人物、动作、声音等信息时选参考素材模板。[1]
| 官方模板名称 | 模板标识 | 起始素材 |
|---|---|---|
| Wan 3.0 Text to Video Workflow | api_wan3_0_t2v | 场景描述 |
| Wan 3.0 Image to Video Workflow | api_wan3_0_i2v | 图片与动作要求 |
| Wan 3.0 Reference to Video Workflow | api_wan3_0_r2v | 参考素材与生成要求 |
这些标识来自 Comfy 公告中的模板链接。可以从公告进入对应模板,也可以在更新后的模板面板中查找。不要因为社区工作流名称相似,就把它认作官方版本。[1]
首尾帧与参考图也不是同一种控制:前者规定镜头边界,后者提供模型需要理解的信息。先用最少的素材表达镜头,再针对具体问题增加参考,通常更容易判断每个输入的作用。
使用官方模板前,先完成账号与积分设置
按下面的顺序配置官方路径:
- 更新 ComfyUI。Wan 3.0 公告写的是 v0.33.4;官方排障页建议缺少 Partner Nodes 时检查当前版本。[1][5]
- 在 Settings → User 登录 Comfy 账号。对于其他受支持的部署方式,官方另有 Comfy API key 登录说明。[7]
- 打开 Settings → Credits,检查付费积分余额。安装本地 ComfyUI 不等于获得不限量的托管模型调用。[8]
- 加载合适的模板,填写提示词、提供要求的素材并连接输出。[1]
- 执行前检查设置与界面显示的费用,先用短片段验证最关心的动作或构图。
缺少节点时,先查版本,再查启动时的导入错误,不要先重装无关扩展。登录失败时,检查账号和访问本地界面的方式。Comfy FAQ 提到了 localhost、127.0.0.1 的限制,登录指南则提供其他部署方式下的 Comfy API 密钥登录步骤,应按实际安装方式处理。[5][7]
这里的密钥属于 Comfy 账号体系。官方 Partner Node FAQ 没有提供把任意模型服务商密钥填进该位置的用法,因此 reAPI 接入需要单独适配。[5]
KSampler 不会把托管 API 变成本地推理
节点图在本机,并不说明其中每个模型都在本机运行。Partner Nodes 调用托管模型;Wan 2.2 原生工作流则会实际加载扩散模型、文本编码器和 VAE。[5][6]
这也是 wan 3 ksampler、wan 3 samplers 两类搜索需要先弄清的区别。连接本地采样器不会补出尚未在官方索引中找到的 Wan 3.0 权重,本地采样器选项也不会自动变成远端 API 参数。[2][3][4]
同一节点图中的其他本地模型仍可能占用显存,例如前置的图片生成步骤。准确的说法是:托管的 Wan 阶段无需把 Wan 3.0 权重加载到你的电脑。完整的本地选型见哪些 Wan 模型可以本地运行。
自建节点调用 reAPI,需要处理哪些环节
如果要使用 reAPI 余额、保存任务 ID,或接入已有任务队列,可以自行实现适配层。这里给出的是接入约定,不是已经随文提供并测试过的现成插件。
把密钥保存在服务端环境变量中,然后提交请求:
curl --fail-with-body https://reapi.ai/api/v1/videos/generations \
-H "Authorization: Bearer $REAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan3.0-video",
"prompt": "A ceramic cup turns slowly on a wooden table, morning light, quiet room ambience",
"resolution": "720P",
"size": "16:9",
"duration": 6,
"audio": true
}'这是依据公开文档编写的请求示例,成功执行会产生费用;本文没有把它作为实际生成测试。reAPI 的 Wan 3.0 必须使用 API 密钥,Playground 只用于配置请求,不能在浏览器中直接提交生成。[4]
读取响应中的任务标识,轮询 GET /api/v1/tasks/{id}。status 到达 completed 后读取 output.video_urls;失败时展示返回的错误。轮询中断后应保留已有任务 ID,避免自动重新提交同一生成。[4]
| 节点图中的输入 | reAPI 字段 | 关键边界 |
|---|---|---|
| 首帧或尾帧 | image_with_roles | 明确使用 first_frame 或 last_frame |
| 人物、风格参考图 | image_with_roles | 使用 reference_image,不能混入帧角色 |
| 动作参考视频 | video_urls | 参考素材,不是专用编辑源 |
| 参考声音 | audio_urls | 必须是公网可访问的素材 URL |
| 文档 | file_url | 一份文档,与 link_url 互斥 |
| 公开网页 | link_url | 无需登录,与 file_url 互斥 |
媒体字段只接受公网 HTTP(S) URL。Comfy 图像对象、本地路径、base64 数据都不能直接替代 URL。素材在本机时先增加上传步骤,再提交生成;帧输入和参考输入不能混用,文档与网页输入最高使用 1080P。[4]
按完整请求估算费用,再决定接入路径
2026 年 9 月 14 日,Wan 3.0 价格表显示:480P 为 $0.035/s,720P 为 $0.068/s,1080P 为 $0.136/s,2K 为 $0.199/s,4K 为 $0.229/s。这里引用的是页面展示价;结构化报价保留了更多小数位。[9]
按展示的 720P 费率计算,10 秒输出为 $0.680,尚未加入参考视频时长和任务积分取整。这是预算估算,不是精确账单。6 秒参考视频加 8 秒输出,代表 14 秒计费时长;参考视频与输出的总时长还必须保持在 30 秒以内。[4]
预算敏感时请明确填写时长。文档说明 duration: -1 按 30 秒上限计费;关闭生成音频不会降低每秒费率,失败任务则自动退款。[4]
| 决策项 | 官方 Comfy 模板 | 自建 reAPI 适配层 |
|---|---|---|
| 初始配置 | 使用已有官方模板 | 需要编写接入逻辑 |
| 付费账号 | Comfy 积分 | reAPI 积分 |
| 可用参数 | 模板暴露的选项 | reAPI 文档公开字段 |
| 批量组织 | 使用工作流现有执行功能 | 自行处理队列、任务存储和重试 |
| 成本判断 | 查看当前节点报价 | 查看模型价格与实际用量 |
本文没有足够的同口径报价来认定哪条路径始终更便宜。想减少接入工作,选官方模板;需要自己控制外围流程,选适配层。自建队列也不意味着无限并发,仍需遵守接口限流。
常见问题
wan 3.0 comfyui
可以使用。Comfy 官方提供文生、图生和参考素材三种托管生成模板,直接从对应模板开始。[1]
comfyui wan 3.0
先更新 ComfyUI、登录 Comfy 账号并检查积分,再加载模板。官方 Partner Nodes 使用 Comfy 的账号体系。[1][5]
wan 3 ksampler
本地 KSampler 不会运行托管的 Wan 3.0 权重。使用远端模型节点,或选择可下载的 Wan 版本构建本地扩散工作流。[6][2]
wan 3 samplers
只能使用所选接入方式公开的控制项。reAPI 的 Wan 3.0 请求结构没有采样器选择字段。[4]
wan 3.0 local tutorial
如果只是本地运行界面,按本文的 API 模板步骤操作;如果要求本机推理,使用 Wan 2.2 原生工作流及其模型文件。[1][6]
wan 3.0 local ios
检查的官方来源没有提供 Wan 3.0 iOS 权重包。在设备上访问托管界面,与在设备上运行模型是两件事。[2][3]
按生成发生的位置选择工作流
希望尽快在节点图里使用托管生成,就从官方模板开始;希望自己管理请求生命周期,就查看 reAPI 模型页和 API 文档。必须本地推理时,继续阅读开放权重状态与本地视频模型对比。明确执行位置、付费账号和参数边界后,Wan 3.0 ComfyUI 才是一条可维护的工作流。
参考资料
- Comfy. Wan 3.0 in ComfyUI: Native 30-Second Video with Omni-Reference Control. 2026 年 9 月 14 日查阅: blog.comfy.org/p/wan-30-in-comfyui-native-30-second
- Wan-Video. Wan. 2026 年 9 月 14 日查阅: github.com/Wan-Video
- Wan-AI. Wan-AI (Wan-AI). 2026 年 9 月 14 日查阅: huggingface.co/Wan-AI/models
- reAPI. Wan 3.0 | reAPI. 2026 年 9 月 14 日查阅: reapi.ai/docs/wan-3-0
- Comfy. FAQs about Partner Nodes - ComfyUI. 2026 年 9 月 14 日查阅: docs.comfy.org/tutorials/partner-nodes/faq
- Comfy. Wan2.2 Video Generation ComfyUI Official Native Workflow Example - ComfyUI. 2026 年 9 月 14 日查阅: docs.comfy.org/tutorials/video/wan/wan2_2
- Comfy. Log in to your Comfy account - ComfyUI. 2026 年 9 月 14 日查阅: docs.comfy.org/account/login
- Comfy. Credits Management - ComfyUI. 2026 年 9 月 14 日查阅: docs.comfy.org/interface/credits
- reAPI. Wan 3.0 — 30-Second Omni-Modal Video Generation. 2026 年 9 月 14 日查阅: reapi.ai/models/wan-3-0
更多文章

Dreamina Seedance 2.5 提示词指南:参考素材与时间控制
按照官方参考素材限制编写更好的 Seedance 2.5 提示词,掌握 30 秒分段、时间戳控制、编辑、延长与关键帧模板。


reAPI 能做什么?图像、视频与 LLM 应用场景
reAPI 目前能做什么?独立的聊天与媒体 API 覆盖图像、视频、音频和语言模型,并提供实际用例与接入清单。


Dreamina Seedance 2.5 用户指南:30 秒与长视频模式
Dreamina Seedance 2.5 通用教程,含 30 秒生成、视频延长、长视频、时间戳、参考素材、编辑、音频清理与故事板实例。
