ComfyUI API Key on Hermes Agent: Enable Cloud Music & Video Workflows

What Is ComfyUI?

ComfyUI is an open-source, node-based interface for building custom AI image, video, and music generation pipelines. Originally a local desktop application, platform.comfy.org is the official cloud platform that lets you run your ComfyUI workflows via API without managing your own GPU hardware. Workflows are JSON graphs that chain together models, samplers, and post-processing steps — giving you far more control than simple prompt-to-image APIs.

On OpenClaw Launch, the ComfyUI integration routes calls from your Hermes Agent instances to the platform.comfy.org cloud API using your personal key. You bring the key; we handle authentication, routing, and applying it to your running Hermes instances instantly.

What Your ComfyUI Key Unlocks on Hermes Agent

Adding a ComfyUI key enables the comfy/workflow model route on your Hermes Agent instances, which covers:

• Music workflows — Generate original music tracks and audio using ComfyUI music pipeline workflows hosted on the ComfyUI cloud, triggered directly from your Hermes Agent conversations
• Video workflows — Run text-to-video and image-to-video ComfyUI workflow graphs on cloud GPUs via the comfy/workflow route, accessible as a tool your Hermes Agent can invoke
• Custom workflow execution — Any ComfyUI-compatible workflow JSON runs on platform.comfy.org infrastructure at pay-as-you-go rates

ComfyUI cloud is a pay-as-you-go service — you are billed for compute time consumed by each workflow run.

How to Get a ComfyUI API Key

1. Go to platform.comfy.org — Open platform.comfy.org/login and sign in or create a new account.
2. Navigate to API Keys — After signing in, open your account settings or the API section in the dashboard. Look for “API Keys” or “Credentials” in the sidebar.
3. Create a new key — Click “Create API Key”. Give it a descriptive name such as “Hermes Agent — OpenClaw Launch” so you can identify it later.
4. Copy your key — Your ComfyUI API key starts with comfy-. Copy it immediately — most platforms only show the full key once at creation time.
5. Add billing credits — ComfyUI cloud is pay-as-you-go. Add credits to your account so workflow runs are not blocked when you start generating.

Add It on OpenClaw Launch

1. Sign in at openclawlaunch.com and open the API Keys page.
2. Find the ComfyUI card. Paste your comfy-... key into the input field and click Save. OpenClaw Launch validates the key live against the ComfyUI API before storing it.
3. Your key is stored encrypted at rest and is applied to all your existing running Hermes Agent instances immediately — no redeploy needed.
4. To use ComfyUI workflows within Hermes, open your instance’s settings and select the desired music or video model from the media settings panel. ComfyUI workflow models will appear once your key is saved.

New to Hermes Agent? See the What is Hermes Agent? guide or the full Hermes Agent BYOK overview.

Using OpenClaw instead? The OpenClaw + ComfyUI guide covers the same steps for OpenClaw instances.

Troubleshooting

401 Unauthorized / Invalid Key

• Verify your key starts with comfy- — keys from the wrong section of the dashboard (e.g. a workspace token vs. an API key) may have a different format
• Check for accidental trailing whitespace when copying — paste into a plain text editor first to confirm the value is clean
• Ensure the key was created under the billing account that has credits loaded; keys from unfunded sub-accounts may authenticate but fail on first workflow run

Workflow Not Found / Model Route Missing

• The comfy/workflow route only appears after a valid ComfyUI key is saved — confirm the key saved successfully on the API Keys page (it will show a green checkmark)
• If the model selector still shows no ComfyUI options after saving, try refreshing your Hermes Agent instance settings page

Quota / Insufficient Credits

• ComfyUI cloud is pay-as-you-go — if your platform.comfy.org account has no credits, workflow runs fail with a billing error. Add credits at platform.comfy.org
• Long video workflows consume significantly more credits than short music clips. Monitor your usage in the ComfyUI dashboard if you run out faster than expected

Frequently Asked Questions

Is ComfyUI cloud free for Hermes Agent users?

No. platform.comfy.org is a pay-as-you-go cloud service regardless of which framework you use. You pay for the GPU compute time each workflow run consumes. There is no free tier — you need to add credits before running workflows.

What is the key prefix for ComfyUI?

ComfyUI API keys start with comfy-. If your key does not begin with this prefix, you likely copied a session token or workspace credential instead of a proper API key. Return to the API Keys section of platform.comfy.org to create one.

Does adding a ComfyUI key affect my running Hermes Agent instances?

Yes. Once you save the key on the API Keys page, it is applied to all your existing running Hermes Agent instances instantly. You do not need to stop, redeploy, or reconfigure anything — ComfyUI workflow models simply become available in your instance media settings.

Can I use ComfyUI alongside other media providers on the same Hermes instance?

Yes. You can have multiple media provider keys saved simultaneously. Each model card in your Hermes Agent instance settings shows which provider it routes through, so you can combine ComfyUI music workflows with fal image models or Runway video models on the same instance.

What's Next?

• OpenClaw + ComfyUI guide — The same ComfyUI setup for OpenClaw instances
• Hermes Agent BYOK overview — Every provider key you can add and what each one unlocks on Hermes
• API Keys page — Add your ComfyUI key now
• AI coding plans compared — Choose the right plan for media-heavy Hermes Agent workloads