> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-comfy-router-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy API v2 Overview

> Reference for the official Comfy API v2: run ComfyUI workflows from external applications by uploading inputs, submitting jobs, and polling for results.

<Warning>
  **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.
</Warning>

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](/development/api-development/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](/development/api-development/sdks-design) for the reasoning behind these.

## Base URLs

| Surface                                                                          | URL                                  | Authentication                                |
| -------------------------------------------------------------------------------- | ------------------------------------ | --------------------------------------------- |
| Comfy Cloud                                                                      | `https://cloud.comfy.org`            | `Authorization: Bearer <api-key>`             |
| Serverless deployment                                                            | `https://{deployment}.run.comfy.app` | `Authorization: Bearer <api-key>`             |
| Self-hosted, via [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) | `http://127.0.0.1:8189`              | None by default, optional static bearer token |

## Endpoint Categories

| Category | Description                                                                            |
| -------- | -------------------------------------------------------------------------------------- |
| Assets   | UUID-identified records over content-addressed blobs. Upload inputs, download outputs. |
| Jobs     | One execution of a workflow. Durable, pollable, and cancelable.                        |

## Comfy Router

Comfy API v2 runs workflows as durable jobs you submit and poll. For direct model calls (one partner model, one request, the model's native input and output), see the [Comfy Router](/api-reference/comfy-router/quickstart) instead.