From 572ff35d2d130dee8ab9f158e02f1c8e9d198043 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 9 Sep 2026 22:13:21 +0000 Subject: [PATCH 1/2] Rename Parallel Execution to Concurrency Limits and clarify UI vs API behavior Rename the Comfy Cloud Parallel Execution section to Concurrency Limits and state clearly that only API submissions run jobs in parallel: the UI runs one job per person, and Team/Enterprise plans give each workspace member their own concurrency. Mirror the same explanation under Pricing and subscription on the Comfy Cloud getting-started page, and update links to the renamed anchor. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01MpPuwjxKzAXSqRQ7UdjEd9 --- development/api-development/sdks.mdx | 2 +- development/cloud/api-reference.mdx | 2 +- development/deploy/cloud.mdx | 8 +++++--- get_started/cloud.mdx | 8 ++++++++ 4 files changed, 15 insertions(+), 5 deletions(-) diff --git a/development/api-development/sdks.mdx b/development/api-development/sdks.mdx index 2900ff9794..d067e1f663 100644 --- a/development/api-development/sdks.mdx +++ b/development/api-development/sdks.mdx @@ -119,7 +119,7 @@ const client = new Comfy({ apiKey: "comfyui-..." }); Works out of the box. Create an [API key](/development/api-development/getting-an-api-key) and pass it to the client. - API access requires a paid Comfy Cloud subscription. The free tier does not include it. How many jobs you can run at once depends on your tier. See [Parallel Execution](/development/deploy/cloud#parallel-execution-concurrent-jobs). + API access requires a paid Comfy Cloud subscription. The free tier does not include it. How many jobs you can run at once depends on your tier. See [Concurrency Limits](/development/deploy/cloud#concurrency-limits). ### Serverless deployment diff --git a/development/cloud/api-reference.mdx b/development/cloud/api-reference.mdx index a38abe0b1f..46de06627e 100644 --- a/development/cloud/api-reference.mdx +++ b/development/cloud/api-reference.mdx @@ -261,7 +261,7 @@ def upload_mask(file_path: str, original_ref: dict) -> dict: Submit a workflow for execution. - **Concurrent submissions supported:** Depending on your subscription tier, you can submit multiple workflows without waiting for previous jobs to complete. Jobs run in parallel up to your tier's limit. Additional jobs queue automatically. See [Parallel Execution](/development/deploy/cloud#parallel-execution-concurrent-jobs) for details and concurrency limits. + **Concurrent submissions supported:** Depending on your subscription tier, you can submit multiple workflows without waiting for previous jobs to complete. Jobs run in parallel up to your tier's limit. Additional jobs queue automatically. See [Concurrency Limits](/development/deploy/cloud#concurrency-limits) for details. ### Submit Workflow diff --git a/development/deploy/cloud.mdx b/development/deploy/cloud.mdx index fd13c59fbc..06ed5443af 100644 --- a/development/deploy/cloud.mdx +++ b/development/deploy/cloud.mdx @@ -71,16 +71,18 @@ See [Running Workflows](/development/run-workflows/overview) for how the same co 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) +## Concurrency Limits -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. +Running multiple jobs in parallel is only supported when you submit workflows through the API. 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`. - 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. + The Comfy Cloud UI does not support running more than one job per person. Workflows queued in the editor run one at a time, in order. Only API submissions run in parallel. See [pricing plans](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api) for subscription details. +On Team and Enterprise plans, concurrency is per member: everyone in the workspace has their own concurrency limit, so one member's running jobs never block another's. + ## 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). diff --git a/get_started/cloud.mdx b/get_started/cloud.mdx index 6c7b3230b2..b5e78a7f08 100644 --- a/get_started/cloud.mdx +++ b/get_started/cloud.mdx @@ -55,6 +55,14 @@ ComfyUI offers both an official cloud version, [Comfy Cloud](https://comfy.org/c View pricing and subscription options for Comfy Cloud +### Concurrency limits + +The Comfy Cloud UI does not support running more than one workflow at a time. Each person can run one workflow at a time in the editor; additional workflows wait in the queue and run one after another. + +Running multiple jobs in parallel is only supported when you submit workflows through the API, which requires a paid subscription. See [Concurrency Limits](/development/deploy/cloud#concurrency-limits) in the developer docs for details. + +On Team and Enterprise plans, concurrency is per member: everyone in the workspace has their own concurrency, so one member's running workflows never block another's. + ## How to use ComfyUI Cloud From 3c948037c9b0964d7f17bd5d7f6a1e8d6d6ffa1b Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 10 Sep 2026 17:17:58 +0000 Subject: [PATCH 2/2] Say Developer Platform for API key creation Replace "your Comfy workspace" wording so API key creation points at the Developer Platform (platform.comfy.org) by name. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01MpPuwjxKzAXSqRQ7UdjEd9 --- development/comfy-router/quickstart.mdx | 2 +- development/deploy/cloud.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/development/comfy-router/quickstart.mdx b/development/comfy-router/quickstart.mdx index d089726246..0ce3bea5b3 100644 --- a/development/comfy-router/quickstart.mdx +++ b/development/comfy-router/quickstart.mdx @@ -10,7 +10,7 @@ Comfy Router lets you call partner models through `https://api.comfy.org` with o - Create a key in [your Comfy workspace](https://platform.comfy.org/profile/api-keys). In a Bash-compatible terminal, set: + Create a key in the [Developer Platform](https://platform.comfy.org/profile/api-keys). In a Bash-compatible terminal, set: ```bash export COMFY_API_KEY="comfyui-..." diff --git a/development/deploy/cloud.mdx b/development/deploy/cloud.mdx index 06ed5443af..2573fdae32 100644 --- a/development/deploy/cloud.mdx +++ b/development/deploy/cloud.mdx @@ -19,7 +19,7 @@ Comfy Cloud works with the [Comfy SDKs](/development/api-development/sdks) out o - 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. + Log in to the [Developer Platform](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.