Skip to main content

​
API Keys

All Developer API requests require authentication via API key. These are the same API keys used for Partner Nodes and other Comfy platform features.

​
Getting Your API Key

API keys are managed at platform.comfy.org:
1

Visit platform.comfy.org and Log In

Go to platform.comfy.org/login and sign in with your Comfy account (Email, Google, or GitHub).Visit Platform Login Page
2

Create an API Key

Click + New in the API Keys section.Create API Key
3

Name Your Key

Enter a descriptive name (e.g., “Production Backend”, “Local Dev”) and click Generate.Enter API Key Name
4

Save Your Key

Copy and save your API key immediately.Obtain API Key
The API key is only shown once at creation. Store it securely - you cannot view it again later.

​
Managing API Keys

You can view and delete your API keys at platform.comfy.org: API Key Management Delete any unused keys or keys that may have been compromised.

​
Using Your API Key

Include the API key in the Authorization header: 
curl https://cloud.comfy.org/developer/api/v1/account \
  -H "Authorization: Bearer comfyui-abc123..."
With the Python SDK: 
from comfy_cloud import ComfyCloudClient

client = ComfyCloudClient(api_key="comfyui-abc123...")

​
Environment Variables

We recommend storing your API key in environment variables: 
export COMFY_API_KEY="comfyui-abc123..."

import os
from comfy_cloud import ComfyCloudClient

client = ComfyCloudClient(api_key=os.environ["COMFY_API_KEY"])
Never commit API keys to version control. Use environment variables or a secrets manager.

​
Environments

EnvironmentBase URL
Productionhttps://cloud.comfy.org/developer/api/v1
Staginghttps://stagingcloud.comfy.org/developer/api/v1
# Using staging
client = ComfyCloudClient(
    api_key="comfyui-...",
    base_url="https://stagingcloud.comfy.org/developer/api/v1",
)

​
Rate Limits

The API has rate limits to ensure fair usage:
LimitValue
Requests per minute600
Concurrent jobsBased on plan
Max upload size100 MB
When rate limited, you’ll receive a 429 Too Many Requests response. Implement exponential backoff in your retry logic.

​
Error Responses

Authentication errors return 401 Unauthorized: 
{
  "error": {
    "type": "unauthorized",
    "message": "Invalid or expired API key"
  }
}
Common causes:
  • Missing Authorization header
  • Malformed header (should be Bearer <key>)
  • Revoked or deleted API key
  • Using wrong environment’s key

Account Login

Full account management and login options

Partner Nodes

Using API keys with Partner Nodes