在 ComfyUI 中使用 ModelSite

ComfyUI 是一款基于节点的图像与视频生成工具。在 ComfyUI 里使用 ModelSite 的模型有两种方式。

如果你在 ComfyUI 界面里工作，请用方案 B。只有在用代码驱动 ComfyUI、并且想沿用 ComfyUI 自带节点和自带模板工作流时，才用方案 A。

两种方案都按 ModelSite 的价格计费，每次请求和其他调用一样出现在你的用量日志里。Key 形如 sk-ms-...，在控制台创建；不要把真实 Key 粘贴进工作流文件、要分享的脚本或截图里。

方案 A：让 ComfyUI 自带的 API 节点指向 ModelSite

1. 用 ModelSite 地址启动 ComfyUI

python main.py --comfy-api-base https://api.modelsite.ai

--comfy-api-base 告诉 ComfyUI 自带的 API 节点把请求发到哪里。测试版本：ComfyUI 0.42.0。

2. 提交工作流并传入 Key

在 ComfyUI 里搭好或打开工作流，用 Workflow → Export (API) 保存成 API 格式。Templates → API 下的模板工作流（例如 api_seedance2_0_mini_t2v、api_wan2_7_t2v、api_happyhorse1_1_t2v）可以作为起点。

把它发给 ComfyUI 的 /prompt 接口，并把 ModelSite 的 Key 放在 extra_data.api_key_comfy_org 里。ComfyUI 会把这个值作为 X-API-KEY 请求头转给 ModelSite。

import json, os, time, requests

COMFY = "http://127.0.0.1:8188"          # 你本机的 ComfyUI
KEY = os.environ["MODELSITE_API_KEY"]    # sk-ms-...

with open("workflow_api.json") as f:     # 用 "Export (API)" 导出
    prompt = json.load(f)

r = requests.post(f"{COMFY}/prompt", json={
    "prompt": prompt,
    "extra_data": {"api_key_comfy_org": KEY},
})
r.raise_for_status()
prompt_id = r.json()["prompt_id"]

# 视频模型需要几分钟：轮询，直到任务出现在 history 里。
while True:
    h = requests.get(f"{COMFY}/history/{prompt_id}").json()
    if prompt_id in h:
        print(json.dumps(h[prompt_id]["outputs"], indent=2))  # 文件在 ComfyUI 的 output 目录里
        break
    time.sleep(5)

3. 哪些能用

用真实的 ModelSite 账号、最低档参数，把模板工作流完整跑通过：

ComfyUI 的节点会发带日期的模型名，例如 dreamina-seedance-2-0-260128、seedream-4-5-251128。ModelSite 会把它们对应到匹配的模型，你不需要改。

4. 方案 A 里不能用的

• 需要先上传文件的节点。 图生视频、参考生视频、首尾帧、视频编辑等节点，会让 ComfyUI 在生成前先上传你的图片或视频。ModelSite 没有这一步上传，所以这些节点会失败。图生视频请用方案 B。
• ModelSite 不在售的模型家族，例如 Kling、Vidu、Luma。它们的节点没有可连接的对象。
• ComfyUI 列表里有、ModelSite 没有的模型：Wan 2.5 文生图、Seedream 5.0 Pro、Qwen Image 3.0 Pro、Seedance 2.0 Fast 和 Seedance 2.5。请求会被拒绝。
• 新模型只有等 ComfyUI 发布新版本才会出现在它的列表里。方案 B 没有这个限制。

方案 B：ModelSite 节点包

节点包提供直接调用 ModelSite 的节点：不需要 ComfyUI 账号，没有登录闸门，也不用改启动参数。

1. 安装

节点包已上架 ComfyUI Registry，名称为 Modelsite。在 ComfyUI Manager 里打开 Custom Nodes Manager，搜索 Modelsite 并点 Install，然后重启 ComfyUI。

也可以用 comfy CLI：

comfy node install comfyui-modelsite

或者把仓库克隆到 custom_nodes 目录：

cd ComfyUI/custom_nodes
git clone https://github.com/binoctal/comfyui-modelsite

重启 ComfyUI。节点包不需要额外的 Python 依赖。

2. 设置 API Key

打开 Settings → Modelsite → Connection，把 Key 粘贴到 API key。Key 只保存在你本机，不会写进工作流，也不会写进生成的文件，所以分享工作流时不会泄露 Key。

或者在启动 ComfyUI 之前设置环境变量 MODELSITE_API_KEY。API 地址默认是 https://api.modelsite.ai；只有拿到了别的地址时才需要改。

3. 添加节点

在画布上双击，搜索 Modelsite。节点在 Modelsite/Video 和 Modelsite/Image 分类下：

把输出接到 ComfyUI 自带的 Save Video 或 Save Image 节点。视频节点还会输出 task_id 和 usage（接口返回的用量数据）。

4. 选择模型

model 下拉框在页面加载时从 ModelSite 的实时模型列表里填充，所以新上架的模型刷新页面就能看到。如果想立刻用，把它的 ID 填进 custom_model，它会覆盖下拉框的选择。

参考视频和音频暂不支持。

用真实账号在 ComfyUI 界面里完整跑通过：Seedance 2.0 mini、Wan 2.7、HappyHorse 1.1、MiniMax H3 的文生视频；Seedance 2.0 mini、Wan 2.7、HappyHorse 1.1、MiniMax H3 的图生视频；Seedream 5.0 lite 文生图和 Seedream 4.5 图生图。表中其他模型用的是同样的节点，但没有逐个跑过。

5. 值得了解的参数

• resolution：Wan 和 HappyHorse 支持 720p、1080p；Seedance 支持 480p、720p、1080p；MiniMax H3 支持 768p（H3 Max 另有 480p）。不支持的取值会在发出请求之前就被拒绝。
• duration：Seedance 4–15 秒，Wan 2–15 秒，HappyHorse 3–15 秒，MiniMax H3 4–15 秒（H3 Max 5–15 秒）。
• seed：-1 让模型自己决定。默认设置会让每次运行都不同，这样 ComfyUI 不会对付费调用复用旧结果。
• generate_audio 只对 Seedance 有效；negative_prompt 只对 Wan 和 HappyHorse 有效；其他模型会忽略它们。
• ratio 用于文生视频；图生视频时结果跟随你的首帧。
• HappyHorse 图生视频 只接受首帧；接上尾帧会报错。

6. 示例工作流

把文件拖到 ComfyUI 画布上即可。图像类工作流读取 ComfyUI input 目录里的 example.png，请换成你自己的图片。

这些文件里都不含 Key。

7. 常见问题

接口返回的错误信息会原样显示。你的 Key 会从每一条错误信息和日志里被去掉。