Skip to main content

发布工作流为线上 API 服务

Comfy 工作流托管平台采用 在线 和 下线 两种状态来管理托管的工作流。这种设计旨在确保工作流在不同生命周期阶段的稳定性和可维护性，并满足生产环境的需求。

工作流状态概述​

托管的工作流拥有在线和离线两种状态，核心目的是为了区分工作流的 生产服务 和 维护更新 阶段，从而保障服务的稳定性和更新的可控性。

  • 在线状态：生产就绪的 API 服务 当工作流处于 已上线 状态时，被视为已发布、生产就绪的 API 服务。此状态下的工作流主要用于对外提供稳定可靠的 API 接口，供用户或应用程序调用。为了保证 API 服务的稳定运行，在线状态的工作流具有以下限制：

    • 环境锁定，不可更改：工作流关联的运行环境（容器镜像）被锁定，用户无法修改或更换环境。这确保了工作流在特定环境下经过充分验证后，其运行环境不会发生意外变更，从而保障服务的稳定性。
    • 参数锁定，工作流文件中的参数配置被锁定，用户无法在线修改工作流的任何参数（可通过 API 传参）。 这避免了在生产服务运行期间，因参数误操作导致服务异常或结果不可预测的情况发生。
    • 工作流文件锁定，不可编辑：工作流文件本身处于锁定状态，用户无法在线替换工作流文件。确保了生产环境中运行的工作流代码是经过严格测试和验证的版本。

  • 下线状态：维护与更新阶段 当工作流处于 待上线 状态时，将 停止提供任何 API 服务。下线状态是用于对工作流进行维护和更新的阶段。例如，当您不再需要为某个特定工作流提供 API 服务时，您可以将其下线。更重要的是，所有对工作流的修改操作，都必须在离线状态下进行。这包括：

    • 更换关联环境： 您可以更换工作流所关联的容器镜像，例如升级环境依赖，或切换到更优化的运行环境。

  • 待校验：工作流未关联运行环境。

  • 校验失败：工作流未关联运行环境，但已关联环境无法运行该工作流。

上线工作流​

工作流处于 待上线 状态时，表示已通过环境验证后，您可以点击 「上线」 按钮将其发布为 已上线 状态，开始提供 API 服务。

当工作流处于 「待上线」 状态并已通过环境校验后，您可以点击「上线」按钮，将其发布为 「已上线」 状态，开始对外提供 API 服务。

获取工作流 API 服务的 CURL 调用示例​

工作流上线之后，可通过 API 调用和集成工作流服务。您可以使用平台生成的 CURL 命令示例进行测试和验证，在终端中直接调用 API 提交生图任务。

在试运行抽屉面板的上方窗口中，切换为 CURL，一键复制 CURL 命令，在命令行中执行。CURL 命令中包含了所有可输入字字段