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

# Comfy Cloud

> 使用 Comfy Cloud 作为始终可用的托管部署，通过 API 运行工作流

Comfy Cloud 是有状态、交互式且完全托管的 ComfyUI 版本。您可以像在本地安装中一样，在浏览器中构建和运行工作流，而 Comfy 负责管理模型、GPU 以及介于两者之间的一切。您还可以直接通过 API 调用它，将 Comfy Cloud 用作无服务器 API 端点：无需构建环境，也无需创建部署。

您可以将其视为一种永久性的无服务器部署。[Serverless API](/zh/development/serverless/overview) 部署服务于一个由您构建并发布的固定环境，而 Comfy Cloud 提供的则是一个完整、托管且始终在线的 ComfyUI。

<Note>
  如果您是初次接触，请参阅 [Comfy Cloud 简介](/zh/get_started/cloud)。本节介绍如何以开发者身份使用 Comfy Cloud API。
</Note>

## 快速入门

Comfy Cloud 开箱即用地支持 [Comfy SDK](/zh/development/api-development/sdks)：基础 URL 默认指向 Comfy Cloud，因此你只需要一个 [API 密钥](/zh/development/api-development/getting-an-api-key) 和一个工作流。API 访问需要付费的 Comfy Cloud 订阅；免费版不包含此功能。

<Steps>
  <Step title="创建 API 密钥">
    在 [platform.comfy.org](https://platform.comfy.org) 登录并创建一个密钥。分步说明请参阅[获取 API 密钥](/zh/development/api-development/getting-an-api-key)。
  </Step>

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

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

  <Step title="以 API 格式导出工作流">
    在 Cloud 编辑器中构建并测试工作流，然后使用 `File → Export Workflow (API)` 将其保存为 `workflow_api.json`。请参阅[工作流 API 格式](/zh/development/api-development/workflow-api-format)。
  </Step>

  <Step title="运行">
    <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"` 是工作流文件中输出节点的 ID。有关输入、进度事件和错误处理的说明，请参阅 [SDK 指南](/zh/development/api-development/sdks)。
  </Step>
</Steps>

有关相同代码如何在 Comfy Cloud、Serverless 和自托管部署之间迁移的说明，请参阅[运行工作流](/zh/development/run-workflows/overview)。

## 积分与使用

API 请求与 Comfy Cloud 网页界面共用同一月度积分配额。没有单独的 API 积分池。各套餐包含的积分、充值选项以及每工作流的运行时长上限，对 API 任务和界面任务完全同样适用。各套餐的月度积分数量请参阅[定价页面](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=cloud-api)。如果月中积分已用完，可从账户仪表盘购买充值。

## 并行执行（并发任务）

API 用户可以并发提交多个工作流，无需等待上一个任务完成。任务被接受后，提交立即返回，因此你可以让多个任务同时进行中。调度器会在你的订阅层级限制内并行运行这些任务；请查看 [platform.comfy.org](https://platform.comfy.org) 了解你当前的并发数。

超出并发限制提交的任务会正常排队，并在有空闲名额时自动执行。如果队列本身已满，SDK 会在有限的预算内为你重试，然后才抛出 `QueueFull`。

<Info>
  并行执行目前仅通过 API 提供。订阅详情请参见[定价页面](https://www.comfy.org/cloud/pricing?utm_source=docs\&utm_campaign=cloud-api)。
</Info>

## 现有的 v1 集成

弃用的 [v1 Cloud API](/zh/development/cloud/overview) 也运行在 Comfy Cloud 上。仅将其用于现有集成，或用于 [Comfy API v2](/zh/api-reference/v2/overview) 尚未提供的云端功能。可运行示例见 [Cloud API 参考](/zh/development/cloud/api-reference)（已弃用）。