> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-router-model-page-pilot.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. The full endpoint documentation is in the API Reference pages of this section, generated from the OpenAPI specification.

## Where v2 Runs

The same API is served by three surfaces, so one integration can move between them by changing the base URL.

**Comfy Cloud.** The managed, multi-tenant service at `https://cloud.comfy.org`. Create an [API key](/development/api-development/getting-an-api-key) and you can submit any workflow. Cloud-specific features such as credits, model browsing, and queue management live on the [v1 Cloud API](/development/cloud/overview), not on v2.

**Serverless API (Developer Platform).** A workflow you deploy through the [Developer Platform](https://platform.comfy.org) gets its own dedicated endpoint at `https://{deployment}.run.comfy.app`, serving the same v2 API with the same API key. A serverless deployment runs one pinned workflow, so it scales independently and `GET /workflow` returns the executed graph. See the [Serverless API guide](/development/serverless/overview) for building and deploying.

**Open-source ComfyUI, via the proxy.** During the beta, a self-hosted ComfyUI speaks v2 through [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy), a small open-source service that runs alongside it:

```bash theme={null}
pip install comfy-api-proxy
comfy-api-proxy
```

By default it proxies the ComfyUI on `127.0.0.1:8188` and serves the v2 API on `127.0.0.1:8189`, binding to loopback only. Authentication is off by default, with an optional static bearer token. The proxy is a stopgap: once v2 stabilizes it moves into ComfyUI core and the proxy is no longer needed. See [Your own ComfyUI](/development/api-development/sdks#your-own-comfyui) in the SDK guide for configuration details.

## 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](/development/comfy-router/quickstart). Review the [Router limitations](/development/comfy-router/limitations) first. Router is not generally available yet.