在 Python/FastAPI Web 应用中接入…

适用于将 ViewComfy API 集成到 Python/FastAPI Web 应用，通过 httpx 调用 serverless ComfyUI 工作流并处理生成结果。

适用场景

解决思路

1. 使用 Python/FastAPI 开发，并用 httpx 库调用 ViewComfy API；ViewComfy API 是 serverless FastAPI 服务，用于执行自定义 ComfyUI 工作流。
2. 调用前预期首次调用可能遇到冷启动；根据工作流不同，生成时间可能少于 2 秒到数分钟，应用需能适应这种延迟。
3. 不要发送空的 params 对象；如果未指定参数，至少修改 seed 值。
4. 解析返回结果时使用以下结构：prompt_id（唯一标识）、status（执行状态）、completed（布尔完成指示）、execution_time_seconds（处理耗时）、prompt（原始配置）、outputs（可选，生成文件数组，包含 filename、content_type、base64 编码数据、size）。
5. 在 ViewComfy dashboard 中使用 workflow_api.json 部署 ComfyUI 工作流。
6. 使用 workflow_parameters_maker.py 提取参数，将配置扁平化。
7. 在实现中配置 endpoint URL、Client ID、Client Secret。
8. 调用 API 时可用 infer（标准 POST）或 infer_with_logs（流式 SSE，用于实时跟踪）。
9. 处理 outputs 时进行 base64 解码，并保存到工作目录。
10. 始终在应用中优雅处理冷启动延迟。
11. 为 API 响应实现正确的错误处理。
12. 对长时间运行的工作流使用流式端点 infer_with_logs，以便向用户提供反馈。
13. 安全存储凭据，绝不在客户端代码中暴露凭据。
14. 发送请求前验证参数，避免不必要的 API 调用。

适用边界 · 注意事项

• 不适用于不使用 ViewComfy API 或不需要执行 ComfyUI 工作流的项目。
• 不适用于无法安全保存 Client Secret 的纯前端或客户端直连场景。
• 如果工作流很短且无需实时反馈，不必强行使用 infer_with_logs。