> ## 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 Cloud

> Use Comfy Cloud as an always-available managed deployment for running workflows via API

Comfy Cloud is a stateful, interactive, fully managed version of ComfyUI. You build and run workflows in the browser as you would on a local install, while Comfy manages the models, the GPUs, and everything in between. You can also call it directly through the API, using Comfy Cloud as a serverless API endpoint: there is no environment to build and no deployment to create.

You can think of it as a permanent serverless deployment. Where a [Serverless API](/development/serverless/overview) deployment serves one pinned environment that you build and release, Comfy Cloud serves a full, managed ComfyUI that is always on.

<Note>
  See the [Comfy Cloud introduction](/get_started/cloud) if you are new to it. This section covers using the Comfy Cloud API as a developer.
</Note>

## Quickstart

Comfy Cloud works with the [Comfy SDKs](/development/api-development/sdks) out of the box: the base URL defaults to Comfy Cloud, so all you need is an [API key](/development/api-development/getting-an-api-key) and a workflow. API access requires a paid Comfy Cloud subscription; the free tier does not include it.

<Steps>
  <Step title="Create an API key">
    Log in at [platform.comfy.org](https://platform.comfy.org) and create a key. See [Getting an API Key](/development/api-development/getting-an-api-key) for step-by-step instructions.
  </Step>

  <Step title="Install the SDK">
    <CodeGroup>
      ```bash Python theme={null}
      pip install comfy-sdk
      ```

      ```bash TypeScript theme={null}
      npm i @comfyorg/sdk
      ```
    </CodeGroup>
  </Step>

  <Step title="Export a workflow in API format">
    Build and test a workflow in the Cloud editor, then save it with `File → Export Workflow (API)` as `workflow_api.json`. See [Workflow API Format](/development/api-development/workflow-api-format).
  </Step>

  <Step title="Run it">
    <CodeGroup>
      ```python Python theme={null}
      from comfy_sdk import Comfy

      client = Comfy(api_key="comfyui-...")  # Comfy Cloud is the default target

      wf = client.workflows.from_file("workflow_api.json")

      job = client.run(wf)
      for output in job.get_outputs("9"):
          output.to_file(output.name)
      ```

      ```typescript TypeScript theme={null}
      import { Comfy } from "@comfyorg/sdk";

      const client = new Comfy({ apiKey: "comfyui-..." }); // Comfy Cloud is the default target

      const wf = await client.workflows.fromFile("workflow_api.json");

      const job = await client.run(wf);
      await job.getOutputs("9")[0].toFile("out.png");
      ```
    </CodeGroup>

    `"9"` is the ID of the output node in your workflow file. See the [SDK guide](/development/api-development/sdks) for inputs, progress events, and error handling.
  </Step>
</Steps>

See [Running Workflows](/development/run-workflows/overview) for how the same code moves between Comfy Cloud, Serverless, and self-hosted deployments.

## Credits and Usage

API requests draw from the same monthly credit allocation as the Comfy Cloud web UI. There is no separate API credit pool. Each tier's included credits, top-up options, and per-workflow runtime caps apply to API jobs in exactly the same way as UI jobs. See the [pricing page](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=cloud-api) for the monthly credit amounts on each tier. If you run out of credits mid-month, top-ups can be purchased from your account dashboard.

## Parallel Execution (Concurrent Jobs)

API users can submit multiple workflows concurrently without waiting for previous jobs to complete. Submission returns as soon as the job is accepted, so you can keep several in flight. The dispatcher runs them in parallel up to your subscription tier's limit; check [platform.comfy.org](https://platform.comfy.org) for your current concurrency.

Jobs submitted beyond your concurrency limit queue normally and execute automatically as slots free up. If the queue itself is full, the SDKs retry for you within a bounded budget before raising `QueueFull`.

<Info>
  Parallel execution is currently available via the API only. See [pricing plans](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=cloud-api) for subscription details.
</Info>

## Existing v1 integrations

The deprecated [v1 Cloud API](/development/cloud/overview) also runs against Comfy Cloud. Use it only for existing integrations or for Cloud capabilities that [Comfy API v2](/api-reference/v2/overview) does not expose yet. Runnable examples are in the [Cloud API Reference](/development/cloud/api-reference) (deprecated).