Skip to main content
Beta: Comfy API v2 is at 0.1.x and the surface may still change. Changes within v2 will be additive; anything breaking would ship as v3.
The official, versioned HTTP API for running ComfyUI workflows from external applications: upload inputs, submit a workflow, observe execution, retrieve results. Most people should start with the Comfy SDKs, which wrap this API in Python and TypeScript. Call these endpoints directly if you are working in another language.

​
Design Principles

  • Poll first. Every capability is reachable via plain GET polling. The SSE stream is a live enhancement, never the source of truth.
  • Everything is resumable. Submission is idempotent, and job state and outputs are retrievable by ID until expires_at.
  • Content-addressed assets. Assets are UUID-identified records over blobs keyed by a server-computed blake3 hash, so identical inputs are not uploaded twice.
  • Follow links, do not build URLs. Responses embed their follow-up URLs.
See Design Notes for the reasoning behind these.

​
Base URLs

​
Endpoint Categories