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

# Authentication

> Authenticate with the ComfyUI Cloud Developer API

## API Keys

All Developer API requests require authentication via API key. These are the same API keys used for [Partner Nodes](/tutorials/partner-nodes/overview) and other Comfy platform features.

### Getting Your API Key

API keys are managed at [platform.comfy.org](https://platform.comfy.org/login):

<Steps>
  <Step title="Visit platform.comfy.org and Log In">
    Go to [platform.comfy.org/login](https://platform.comfy.org/login) and sign in with your Comfy account (Email, Google, or GitHub).

    <img src="https://mintcdn.com/dripart-dev-api-v1/XkceYR_brx79f9DZ/images/interface/setting/user/user-login-api-key-1.jpg?fit=max&auto=format&n=XkceYR_brx79f9DZ&q=85&s=36077d31a8f22bce980b3e265fb9baa1" alt="Visit Platform Login Page" width="2294" height="1430" data-path="images/interface/setting/user/user-login-api-key-1.jpg" />
  </Step>

  <Step title="Create an API Key">
    Click **+ New** in the API Keys section.

    <img src="https://mintcdn.com/dripart-dev-api-v1/XkceYR_brx79f9DZ/images/interface/setting/user/user-login-api-key-2.jpg?fit=max&auto=format&n=XkceYR_brx79f9DZ&q=85&s=d2a586324f91d1fa04b60d4485c602ed" alt="Create API Key" width="2298" height="1432" data-path="images/interface/setting/user/user-login-api-key-2.jpg" />
  </Step>

  <Step title="Name Your Key">
    Enter a descriptive name (e.g., "Production Backend", "Local Dev") and click **Generate**.

    <img src="https://mintcdn.com/dripart-dev-api-v1/XkceYR_brx79f9DZ/images/interface/setting/user/user-login-api-key-3.jpg?fit=max&auto=format&n=XkceYR_brx79f9DZ&q=85&s=4a416ba5e31c3020558eb73214708222" alt="Enter API Key Name" width="2298" height="1432" data-path="images/interface/setting/user/user-login-api-key-3.jpg" />
  </Step>

  <Step title="Save Your Key">
    Copy and save your API key immediately.

    <img src="https://mintcdn.com/dripart-dev-api-v1/XkceYR_brx79f9DZ/images/interface/setting/user/user-login-api-key-4.jpg?fit=max&auto=format&n=XkceYR_brx79f9DZ&q=85&s=d9969afcebef648161adb17acdc02b3c" alt="Obtain API Key" width="2298" height="1432" data-path="images/interface/setting/user/user-login-api-key-4.jpg" />

    <Warning>
      The API key is only shown once at creation. Store it securely - you cannot view it again later.
    </Warning>
  </Step>
</Steps>

### Managing API Keys

You can view and delete your API keys at [platform.comfy.org](https://platform.comfy.org/login):

<img src="https://mintcdn.com/dripart-dev-api-v1/XkceYR_brx79f9DZ/images/interface/setting/user/user-login-api-key-5.jpg?fit=max&auto=format&n=XkceYR_brx79f9DZ&q=85&s=9519886bf1d93fdd4bc62690991297ea" alt="API Key Management" width="2298" height="1432" data-path="images/interface/setting/user/user-login-api-key-5.jpg" />

Delete any unused keys or keys that may have been compromised.

## Using Your API Key

Include the API key in the `Authorization` header:

```bash theme={null}
curl https://cloud.comfy.org/developer/api/v1/account \
  -H "Authorization: Bearer comfyui-abc123..."
```

With the Python SDK:

```python theme={null}
from comfy_cloud import ComfyCloudClient

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

### Environment Variables

We recommend storing your API key in environment variables:

```bash theme={null}
export COMFY_API_KEY="comfyui-abc123..."
```

```python theme={null}
import os
from comfy_cloud import ComfyCloudClient

client = ComfyCloudClient(api_key=os.environ["COMFY_API_KEY"])
```

<Warning>
  Never commit API keys to version control. Use environment variables or a secrets manager.
</Warning>

## Environments

| Environment | Base URL                                          |
| ----------- | ------------------------------------------------- |
| Production  | `https://cloud.comfy.org/developer/api/v1`        |
| Staging     | `https://stagingcloud.comfy.org/developer/api/v1` |

```python theme={null}
# 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:

| Limit               | Value         |
| ------------------- | ------------- |
| Requests per minute | 600           |
| Concurrent jobs     | Based on plan |
| Max upload size     | 100 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`:

```json theme={null}
{
  "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

## Related

<CardGroup cols={2}>
  <Card title="Account Login" icon="user" href="/account/login">
    Full account management and login options
  </Card>

  <Card title="Partner Nodes" icon="plug" href="/tutorials/partner-nodes/overview">
    Using API keys with Partner Nodes
  </Card>
</CardGroup>
