文档中心
控制台

ComfyUI API 错误码 ​

连接 AI 助手

本页适用于 ComfyStack 工作流托管 API。接口可能返回包含 code、msg 和 data 的 JSON 响应体。部分业务错误会使用 HTTP 200 承载非 0 的响应体 code，排查问题时，请同时查看 HTTP 状态码、响应体 code、msg 和工作流调用记录。

language-json
{
  "code": 60400,
  "msg": "There are no eligible missions in comfyTask",
  "data": null
}

响应字段：

  • code：业务错误码或系统错误码。0 通常表示成功；非 0 表示失败。
  • msg：错误信息。本文档中用 {...} 表示运行时详情；实际响应会替换为具体字段、工作流、限制值或失败原因。
  • data：成功时的响应数据；失败时可能为空。

标记为“已弃用”的错误码不应作为新集成的处理依据；现有集成如仍需兼容历史响应，可保留相应处理。请以各条目中的替代说明和接口实际响应为准。

10025 ​

  • HTTP 状态码：200。
  • 错误信息：以实际响应为准，常见返回为 功能暂不可用。
  • 适用场景：接口返回功能暂不可用，且请求尚未开始处理。
  • 可能原因：当前账号暂时无法使用该 API。
  • 处理建议：确认服务开通状态和账号权限；如需继续使用，请联系管理员或技术支持。
  • 是否建议重试：否。

21002 ​

  • HTTP 状态码：200。
  • 错误信息格式：call comfy check service failed [{reason}]
  • 适用场景：检查工作流，或取消已结束的任务。
  • 可能原因：工作流校验请求未能完成，或任务已经成功或失败，无法再取消。
  • 处理建议：校验请求未完成时可稍后重试；任务已经结束时无需重试。如问题持续出现，请记录请求信息并联系技术支持。
  • 是否建议重试：视情况。

60400 ​

  • 错误信息："There are no eligible missions in comfyTask"
  • 适用场景：提交或运行 ComfyUI 工作流。
  • 可能原因：当前没有可运行的工作流，或运行条件暂不满足。
  • 处理建议：确认工作流已发布为 API 服务，并检查运行环境、任务状态和调用参数。
  • 是否建议重试：是。

60401（已弃用） ​

  • 状态：已弃用。
  • 替代错误码：暂无已确认的一一对应替代错误码。
  • 错误信息格式：Get oss config fail err [{reason}]
  • 历史说明：该错误码曾用于工作流任务读取所需文件配置失败。
  • 处理建议：请以当前接口实际返回的 code 和 msg 为准；如问题持续出现，请记录请求信息并联系技术支持。
  • 是否建议重试：请按当前错误响应处理。

60402（已弃用） ​

  • 状态：已弃用。
  • 替代处理：工作流校验请求未成功完成时，可能返回 21002。请求已完成但工作流未通过校验时，调用工作流检查接口请查看 success、err_msg.code 和 err_msg.message；创建工作流后请查看工作流状态和 validation_err_msg。此类失败不使用单一替代错误码。
  • 错误信息格式：check workflow fail err [{reason}]
  • 适用场景：上传、保存、试运行或调用工作流时的工作流校验。
  • 可能原因：工作流文件、节点、模型资产、运行环境或输入参数未通过校验。
  • 处理建议：收到 21002 时，按该错误码的适用场景处理；当 success 为 false 时，根据 err_msg.code 和 err_msg.message 修正工作流；工作流状态显示校验失败时，根据 validation_err_msg 修正工作流。
  • 是否建议重试：视情况。

60403 ​

  • 错误信息格式：The number of uploaded workflows exceeds the limit, current num is [{current_count}]
  • 适用场景：上传或创建托管工作流。
  • 可能原因：当前租户上传的工作流数量超过限制。
  • 处理建议：删除不再使用的工作流，或联系技术支持调整限制。
  • 是否建议重试：否。

60404 ​

  • 错误信息格式：the workflow [{workflow}] has no json file
  • 适用场景：发布、试运行或调用托管工作流。
  • 可能原因：指定工作流缺少可执行的工作流 JSON 文件。
  • 处理建议：重新上传工作流 JSON 文件，或确认已上传的工作流文件是否完整。
  • 是否建议重试：否。

60405 ​

  • 错误信息："上线状态的workflow不允许修改运行环境，请先下线后再操作"
  • 适用场景：修改已上线工作流的运行环境。
  • 可能原因：工作流处于上线状态，不允许直接修改运行环境。
  • 处理建议：先下线工作流，再修改运行环境；确认后重新上线。
  • 是否建议重试：否。

60406 ​

  • 错误信息："只允许已上线状态的workflow操作下线"
  • 适用场景：下线工作流。
  • 可能原因：工作流当前不是已上线状态。
  • 处理建议：刷新工作流状态，确认工作流已经上线后再执行下线操作。
  • 是否建议重试：否。

60407 ​

  • 错误信息："只允许待上线状态的workflow操作上线"
  • 适用场景：上线工作流。
  • 可能原因：工作流当前不是待上线状态。
  • 处理建议：确认工作流已完成必要配置和校验，并处于待上线状态后再执行上线操作。
  • 是否建议重试：否。

60408 ​

  • 错误信息："租户内存在重复名称"
  • 适用场景：创建或重命名工作流。
  • 可能原因：当前租户下已有同名工作流。
  • 处理建议：改用不重复的工作流名称。
  • 是否建议重试：否。

60409 ​

  • 错误信息格式：{reason}
  • 适用场景：校验工作流名称。
  • 可能原因：工作流名称不符合平台校验规则，具体原因以 msg 为准。
  • 处理建议：根据 msg 修改工作流名称。
  • 是否建议重试：否。

60410 ​

  • 错误信息格式：模型数量超限，请删除部分模型后再重试创建，目前支持最大{limit}个模型
  • 适用场景：为工作流或运行环境配置模型资产。
  • 可能原因：模型数量超过当前限制。
  • 处理建议：删除不再使用的模型资产，或减少当前工作流依赖的模型数量。
  • 是否建议重试：否。