快速体验 ComfyUI 工作流托管服务

为了让您快速体验 ComfyUI 工作流的云端托管和 API 调用功能，我们提供了一组预置的示例工作流。您无需上传自己的工作流文件，即可体验完整的工作流托管服务。

NOTE

无问芯穹提供 ComfyUI 工作流托管服务，可方便地把 ComfyUI Workflow 发布为稳定、可扩展、生产可用的 API 服务。参考 使用 GenStudio 全托管 ComfyUI 工作流，提升 AI 图像生成效率。

体验目标

• 模拟上传工作流（使用预置示例）
• 在线预览 ComfyUI 工作流的参数和节点图
• 在线编辑 ComfyUI 工作流的参数
• 在线提交生成任务，预览生图结果
• 通过 API 提交生成任务，获取生图结果

使用预置示例模拟上传工作流

您无需上传自己的工作流文件，点击平台预置示例即可完成上传流程。

1. 前往 GenStudio ComfyUI 托管服务的工作流页面。

   ComfyUI 工作流

2. 点击上传 Workflow 按钮，在弹出的上传对话框中，任选一个示例工作流。自行填写工作流名称，平台会自动填充对应的 JSON 文件。

   

   • 上传 API JSON 文件（必传）：API Workflow JSON
   • 上传 JSON 文件：标准 Workflow JSON

3. 使用示例创建的工作流，平台会默认为其关联预置环境，并置为「已上线」状态，这表示当前工作流已被发布为 API 服务。

   

NOTE

如果上传自己的工作流，平台会对工作流 JSON 文件进行校验，例如使用的自定义节点是否在预置环境支持列表中。

预览工作流的参数和节点图

在工作流列表中点击进入详情页。工作流详情页提供了一个完整的在线调试环境：

• 左侧默认展示「参数调整」标签页。首次使用时，仅展示部分必要参数。参数表单可自行编辑，以添加更多调试参数。
• 右侧可展示 Workflow 预览界面，支持缩放拖动查看。预览功能要求工作流中同时包含 Workflow JSON 和 API Workflow JSON。

NOTE

节点图仅用于展示，不支持直接在图上编辑节点或连接。

「参数调整」标签页默认未展示全部节点，您可以展开节点列表，搜索和选中更多节点。

试运行工作流

1. 在详情页的左侧参数面板中，确认调试参数后，点击右侧「试运行」按钮。

   

2. 展开右侧的试运行抽屉面板后：

   • 上方可切换展示当前 CURL 请求和 Prompt 参数（同 --data 输入值），参数值与左侧「参数调整中」标签页中的值一一对应，支持一键复制。
   • 下方可一键发起试运行，展示工作流实时进度、预览结果图片（可能有多张）、当次任务推理耗时、当次生图任务花销金额。

   

体验 API 调用

ComfyUI 工作流处于「已上线」状态时，表示该工作流已发布为生产可用的 API 服务。可尝试通过 API 提交生成任务，获取生图结果。

1. 创建并获取 API 密钥。

   API 密钥管理

2. 准备好 API 密钥后，提交生图任务。在试运行抽屉面板的上方窗口中，一键复制 CURL 请求命令，在命令行中执行。注意替换 --header 'Authorization: Bearer $API_KEY' \ 中的 $API_KEY 为真实 API Key（如需使用环境变量请改为双引号""）。

   

3. 在命令行界面提交任务后，返回类似下方响应。其中 prompt_id 字段为任务 ID，可以用于获取任务进度、生图结果。

   {
       "code": 0,
       "msg": "Success",
       "data": {
           "prompt_id": "cft-dasqsd76kuki3abd",
           "prompt_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRfaWQiOiJleGFtcGxlLXdvcmtmbG93My10ZS1iOTA1NzU0NDI3MzUyMjYxIiwidGFza19pZCI6ImNmdC1kYXNxc2Q3Nmt1a2kzYWJkIiwiaXNzIjoiaW5maW5pIiwiZXhwIjoxNzM5ODkzMTk1fQ._oMtN0PEL9uWHAjhvV0I8P1xs_8Soptb9KzeDGlaULw"
       }
   }

4. 稍等片刻后，获取生图结果。请注意替换 comfy_task_ids 数组的值为您自己的任务 ID。

   NOTE

   本次体验仅简单获取结果。API 服务提供任务状态、队列信息，且额外提供 WebSocket 接口。

   curl --request POST \
   --url https://cloud.infini-ai.com/api/maas/comfy_task_api/get_task_info \
   --header 'Accept: application/json' \
   --header "Authorization: Bearer $API_KEY" \
   --header 'Content-Type: application/json' \
   --data '{
   "comfy_task_ids": [
       "cft-dasqsd76kuki3abd"
   ],
   "url_expire_period": 1000
   }'

   在命令行界面提交任务后，返回类似下方响应。其中 final_files 字段包含最终生图结果的 OSS 链接，可通过浏览器直接下载并查看图片。

   {
       "code": 0,
       "msg": "Success",
       "data": {
           "comfy_task_info": [
               {
                   "comfy_task_id": "cft-dasqsd76kuki3abd",
                   "status": 3,
                   "queue_size": 0,
                   "current_position": 0,
                   "errMsg": "",
                   "files": {
                       "49": [
                           "https://infini-imagegen.oss-cn-beijing.aliyuncs.com/example-workflow3-te-b905754427352261%2Fac-c66h4ddlwutmbinv%2Fcft-dasqsd76kuki3abd%2F37913efc-4887-4fae-8099-a1da1414b424.png?Expires=1739808837&OSSAccessKeyId=LTAI5tBgzFapTV38XHKZjHPa&Signature=O1Elx3ktoxXNyOYyvd2xqKx4wos%3D&x-oss-process"
                       ],
                       "58": [
                           "https://infini-imagegen.oss-cn-beijing.aliyuncs.com/example-workflow3-te-b905754427352261%2Fac-c66h4ddlwutmbinv%2Fcft-dasqsd76kuki3abd%2Ff1d896ae-2a11-48c5-8c77-46d959aacfd9.png?Expires=1739808837&OSSAccessKeyId=LTAI5tBgzFapTV38XHKZjHPa&Signature=udwLxeJ4wkd6zl8g7L9R0zajkCI%3D&x-oss-process"
                       ],
                       "202": [
                           "https://infini-imagegen.oss-cn-beijing.aliyuncs.com/example-workflow3-te-b905754427352261%2Fac-c66h4ddlwutmbinv%2Fcft-dasqsd76kuki3abd%2Fb0d482e6-69dd-4e30-966e-967b0941411c.png?Expires=1739808837&OSSAccessKeyId=LTAI5tBgzFapTV38XHKZjHPa&Signature=kfLwoW3XJpDVrj8ZNApOibO2oOo%3D&x-oss-process"
                       ]
                   },
                   "raw_files": null,
                   "final_files": [
                       "https://infini-imagegen.oss-cn-beijing.aliyuncs.com/example-workflow3-te-b905754427352261%2Fac-c66h4ddlwutmbinv%2Fcft-dasqsd76kuki3abd%2F37913efc-4887-4fae-8099-a1da1414b424.png?Expires=1739808837&OSSAccessKeyId=LTAI5tBgzFapTV38XHKZjHPa&Signature=O1Elx3ktoxXNyOYyvd2xqKx4wos%3D&x-oss-process"
                   ],
                   "progress_num": 100,
                   "messages": null
               }
           ]
       }
   }

后续步骤

完成以上步骤后，您就已经了解了 ComfyUI 工作流的基本使用流程。接下来，您可以：

• 尝试修改参数，观察生成结果的变化。暂仅支持修改部分关键参数。
• 使用生成的 curl 命令，在终端中直接调用 API。CURL 命令中包含了所有可输入字字段，您可以根据需要调整。
• 关于 API 端点的路径、参数等细节，详见 ComfyUI HTTP API 参考文档。
• 开始准备上传您自己的工作流。详细对接流程请参见 ComfyUI 工作流托管服务 API 教程。

NOTE

示例工作流仅用于功能体验，如需在生产环境中使用，请上传您自己的工作流。