API 结果怎么取回：从任务历史到实际图片文件

用途与适用范围

工作流执行成功后，调用方还需要知道哪些节点产生了结果、结果保存在什么位置，以及如何取回。不要把节点 ID、文件名和任务 ID 混成一个字段。

已核对的依据

官方路由包含任务历史和 /view 文件读取，执行事件说明 executed 只是节点 UI 更新。不同输出节点的结果结构可能不同，所以解析器应按实际节点和返回数据处理。 D09 D10

开始前需要分清的事项

1. 已经获得明确的 prompt_id，并知道目标实例和授权方式。

2. 工作流中存在会保存或返回所需数据的输出节点。

3. 输出文件名和子目录来自服务器响应，而不是用户输入的任意绝对路径。

操作与检查步骤

以下步骤是基于所列资料编排的操作建议；具体文件、版本和运行环境仍需按实际项目核对。

第 1 步。 等待成功终态或查询该 prompt_id 的历史，失败时读取错误并停止把空结果当成仍在排队。

第 2 步。 遍历实际存在的 outputs，按已支持节点类型读取图片或其他资源信息，不假设某个固定 ID 永远是 SaveImage。

第 3 步。 请求文件时保留返回的 filename、subfolder 和 type，用 URLSearchParams 编码，避免手工拼接产生字符或路径问题。

第 4 步。 保存结果与任务关联，校验响应类型和长度，并为已清理的临时文件提供明确提示，不无限轮询。

可复制的检查命令

图片查询参数示意（item 来自可信任务历史）：

const query = new URLSearchParams({
  filename: item.filename,
  subfolder: item.subfolder ?? "",
  type: item.type ?? "output",
});
const fileUrl = `${COMFY_BASE_URL}/view?${query}`;

完成后的检查

客户端得到属于当前任务的真实产物，并能够追溯到输出节点和保存类别；多个并发请求不会串结果。

注意事项与尚未确认的部分

不同视频与自定义输出结构需要独立适配。不要允许公开接口通过任意路径参数读取服务器文件。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D09 · ComfyUI Server API routes。核对：2026-09-21。
• D10 · ComfyUI execution messages。核对：2026-09-21。

相关排查与操作

• WebSocket 有连接却收不到结果：按 prompt_id 跟踪终止状态
• 队列很快结束却没有新文件：检查缓存、输出节点和保存位置