关联运行环境
ComfyUI 作为一种基于节点的工作流编排工具，其扩展性很大程度上依赖于第三方节点。ComfyUI 节点通常基于 Python 代码实现的，可能依赖于特定的 Python 库及其版本。当用户安装和使用多个节点时，不同节点之间可能存在依赖冲突，导致环境配置复杂且容易出错。
即使借助虚拟环境，在生产环境中管理多个 ComfyUI 工作流时，仍面临环境污染、工作流复现性、环境维护等挑战。
什么是工作流环境？
为了更好地实现环境隔离，平台推出了多运行环境方案。利用容器镜像，为每个 ComfyUI 工作流提供一个隔离的、独立的运行环境。
- 容器镜像隔离： 每个 ComfyUI 工作流及其依赖的节点和 Python 环境被打包到一个独立的容器镜像中。
- 环境定制化： 用户可以根据工作流的具体需求，自定义构建容器镜像。用户可以自由选择 Python 版本、预装所需的 Python 包、配置系统库等，从而精确控制工作流的运行环境。
- 工作流与环境关联： 平台允许用户将环境（容器镜像）与特定的 ComfyUI 工作流进行关联。当用户运行工作流时，平台会自动在关联的容器环境中执行，确保工作流运行在预期的环境中。
为了确保工作流在上线后能够稳定运行，工作流必须先经过与其关联环境的验证，才能被发布到在线状态。平台会在工作流与环境关联时，自动进行环境兼容性检查，确保工作流及其依赖的节点、库与所选容器镜像环境能够良好匹配。未通过校验的工作流将无法运行，从而避免因环境问题导致的服务故障。
预置环境与私有环境
预置环境类似 ComfyUI 整合包等，提供了一个开箱即用的 ComfyUI 环境，预先配置了常见的模型、节点以及依赖项，无需复杂的环境搭建，即可立即开始工作流创作。
注意
如果需要制作私有环境，请联系商务或售后服务。
与计费的关系
为了便于理解计费文档中的「版本规格」，需要明确它与运行环境的对应关系：
- 平台提供的预置运行环境分为不同「版本规格」，例如：标准版 / 大显存版 / 加速版 / 大显存加速版。
- 按量计费：当工作流在某个预置运行环境中执行时，费用按该环境对应的「版本规格」单价计费（单位：秒）。
- 包并发服务：并发槽位需按「版本规格」购买（如购买“大显存版”并发，则仅保障绑定到大显存版环境的工作流请求）。超过 100 个并发可获得更优惠价格。
- 私有环境（自定义运行环境）：功能上与预置环境一致，但不在计费文档的在线刊例价格覆盖范围，价格需联系商务或售后确认。
提示
选择运行环境会直接影响费用档位与性能表现，例如选择「大显存加速」环境将按对应的加速档位计价，同时具备更高的显存与优化策略。请结合模型/分辨率/并发需求选择合适环境。
关联环境
新建托管工作流后，工作流处于「待校验」状态，尚未关联工作流运行环境。点击关联环境，进入下一步。
在「环境配置」标签页中，选择一个环境进行关联。平台会将比对工作流文件与目标运行环境中的模型、节点。
如果您选择的环境可支持工作流运行，则校验通过，工作流进入「待上线」状态，可在详情页操作上线。
注意
如果工作流进入「校验失败」状态，说明您选择的环境无法支持工作流运行。请检查以下内容：
- 托管工作流时，是否在上传 API JSON 文件误传了工作流 JSON 文件。
- 如果关联了预置环境，说明工作流中使用的自定义节点和模型不在预置环境中。您需要制作私有环境。
- 如果关联了私有环境，说明工作流中使用的自定义节点和模型不在该私有环境中。请关联其他环境或制作私有环境。
如果是已上线的工作流，需要先进行下线，才能更换关联环境。
查看私有环境关联记录
您可以查看私有 ComfyUI 运行环境已关联的所有工作流。
访问 ComfyUI 工作流平台环境管理页面，点击环境。进入详情页后，点击关联记录。
在关联记录标签页，可查看已关联工作流的名称、ID、状态（已上线、未上线、校验失败）、创建者、创建时间等元数据。
修改私有环境参数配置
可自行修改私有 ComfyUI 运行环境的启动参数。
访问 ComfyUI 工作流平台环境管理页面，点击环境。进入详情页后，点击参数配置。
进入修改参数配置页面，可修改预置选项，或添加自定义参数，页面底部将提供实时预览。
注意
禁用
--listen和--port参数。确认修改后，环境立即滚动更新，无需停止线上业务。
重要
- 虽然环境更新不会导致业务中断，但仍推荐在业务相对空闲的时间段进行环境参数更新，以尽量缩短滚动更新总时长。
- 针对线上关键业务，请务必确保修改后参数的正确性。例如，请勿引入互相冲突的参数配置。
后续步骤
新建托管工作流后，工作流处于「待校验」状态，下一步：
- 试运行：参考在线调试工作流的操作，在线调试工作流参数，预览结果图片、查看推理时长等。注意工作流未上线时不支持 API 调用。
- 在线调试、编辑工作流： 工作流未上线时，可在详情页修改参数，并保存到工作流中。
- 上线工作流：将工作流发布为线上 API 服务。后续在搭建 API 流程时，我们将使用 ComfyStack 平台，获取工作流 ID 和工作流参数。