设计原则
- 优先轮询。 每项能力都可以通过简单的 GET 轮询访问。SSE 流是实时增强,绝不是事实来源。
- 一切皆可恢复。 提交是幂等的,在
expires_at之前,任务状态和输出均可通过 ID 检索。 - 内容寻址资产。 资产是基于内容寻址 blob 的 UUID 标识记录,blob 以服务器计算的 blake3 哈希为键,因此相同的输入不会被重复上传。
- 跟随链接,不要自行构造 URL。 响应中嵌入了后续 URL。
官方 Comfy API v2 参考:从外部应用上传输入、提交工作流任务并轮询获取结果,在 ComfyUI 中运行工作流。
expires_at 之前,任务状态和输出均可通过 ID 检索。