在 ComfyUI 中使用 Inferway H3 视频生成

准备工作

1. ComfyUI 0.35.0 或更高版本，运行在 Python 3.10 或更高版本上。ComfyUI 启动日志里会打印这两个版本。
2. 一个 Inferway API key：登录后在「控制台 → Keys」中创建。
3. 账户余额。每生成一个视频计费一次，当前价格见定价页。

第一步：安装插件

使用 ComfyUI-Manager：打开 Custom Nodes Manager，搜索 Inferway H3，点 Install，然后重启 ComfyUI。如果版本一栏只有 nightly，直接安装即可，它就是最新发布的代码。

手动安装（Manager 不可用或拒绝安装时）：把仓库克隆到 custom_nodes 目录，再用运行 ComfyUI 的那个 Python 安装它唯一的依赖。

cd ComfyUI/custom_nodes
git clone https://github.com/inferway/comfyui-inferway inferway-comfy
# Use the Python that runs ComfyUI
# (Windows portable build: ..\..\python_embeded\python.exe)
python -m pip install -r inferway-comfy/requirements.txt

第二步：配置 API key

插件节点上没有填 key 的地方，所以分享出去的工作流文件里不会带上 key。插件从 ComfyUI 进程的环境变量 INFERWAY_API_KEY 读取 key：设置好之后重启 ComfyUI。

Windows 上的 ComfyUI Desktop：在终端里执行一次 setx INFERWAY_API_KEY "你的key"，然后重启应用。macOS 上的 ComfyUI Desktop：执行 launchctl setenv INFERWAY_API_KEY "你的key"，然后重启应用；每次电脑重启后需要再执行一次。

# macOS / Linux: in the shell that starts ComfyUI
export INFERWAY_API_KEY="your-key"
python main.py

# Windows portable: add to run_nvidia_gpu.bat (or run_cpu.bat),
# above the line that starts ComfyUI
set INFERWAY_API_KEY=your-key

第三步：确认装好了

重启后，在画布空白处双击并搜索 Inferway，应能看到三个节点。Inferway H3 Generate 用于生成视频。Inferway H3 Resume 用任务 ID 取回已有任务的视频，不会新建任务，也不会再次计费。Inferway H3 Cancel 用于取消云端仍在运行的任务。

第四步：生成第一个视频

首尾帧：打开同一目录下的 first-last-frame.json，分别载入开头和结尾两张图片，模型会生成两者之间的镜头。图片输入模式只在模型列表公布该模式时可用。节点会在创建任务之前检查，所以模式不可用时不会产生费用。

1. 从 https://github.com/inferway/comfyui-inferway/blob/main/workflows/ui 下载文生视频工作流 t2v.json，在 ComfyUI 中按 Ctrl+O 打开。
2. 修改提示词。时长可选 5 到 10 秒，分辨率可选 1344×768 或 768×1344。
3. 点击 Run。生成通常需要几分钟，完成后 MP4 保存在 ComfyUI 的 output/video 目录下。

如何避免重复扣费、如何真正取消

ComfyUI 的 Stop 按钮和节点的本地等待超时，只会停止 ComfyUI 这一端的等待；云端任务会继续运行，完成后照常计费。要真正停止任务，请用 Inferway H3 Cancel 节点并填入任务 ID，节点会显示这次是否计费。

如果中途断网、关闭了浏览器或等待超时，请不要再次点击 Run，那样会新建任务并再计费一次。请在控制台的视频历史中找到任务 ID，或用运行 ComfyUI 的 Python 执行 python -m inferway_comfy history --limit 20，然后用 Inferway H3 Resume 节点取回视频。

常见问题

1. 插件显示 IMPORT FAILED，或者搜不到 Inferway 节点：确认 ComfyUI 运行在 Python 3.10 或更高版本上，并且依赖是用同一个 Python 安装的，然后重启。
2. 节点提示 API key 无效：ComfyUI 进程没有读到 INFERWAY_API_KEY。按第二步设置后重启 ComfyUI；已经在运行的 ComfyUI 不会读取新设置的变量。
3. 节点提示模式不可用：你连接的图片输入模式当前未开放。请改用文生视频，或在首尾帧模式开放时使用首尾帧。
4. 节点提示模式冲突：同一个节点同时连接了首尾帧图片和参考图。每个任务只能使用其中一种。
5. ComfyUI-Manager 拒绝安装：按第一步的手动方式安装。
6. 在 ComfyUI 内置的 API 节点列表里找不到 Inferway：那个列表只包含 ComfyUI 自带的节点。Inferway 是第三方插件，按上面的步骤安装即可。