comfy-cloud-axi

Comfy Cloud CLI for agents — designed with AXI. Generate images, video, and audio via 22 partner models. Submit ComfyUI workflows and templates. Track jobs, estimate credits, search models and nodes, and report usage — all through a shell CLI with token-efficient TOON output.

Setup

export COMFY_CLOUD_API_KEY="your-api-key"

Get your API key at platform.comfy.org/profile/api-keys.

Quick Start

Install the skill (recommended)

npx skills add intelligentrascal/comfy-cloud-axi --skill comfy-cloud-axi -g

Zero setup

npx -y comfy-cloud-axi

Session hook

npm install -g comfy-cloud-axi
comfy-cloud-axi setup hooks

Commands

Discovery

| Command | Description | |---|---| | comfy-cloud-axi catalog | Model type / template tag / node category taxonomy | | comfy-cloud-axi guide <model-or-topic> | Prompting guide for a model family | | comfy-cloud-axi guide partner | Full playbook: all 22 partner model slugs + routing | | comfy-cloud-axi technique | List creative technique recipes | | comfy-cloud-axi technique <name> | Fetch a step-by-step recipe | | comfy-cloud-axi estimate template <name> | Estimate credits for a template (read-only) | | comfy-cloud-axi estimate workflow <file> | Estimate credits for a workflow JSON file (read-only) |

Partner Generation

| Command | Description | |---|---| | comfy-cloud-axi generate <model> "<prompt>" | Show spend request — no credits charged | | comfy-cloud-axi generate <model> "<prompt>" --confirm | Generate and spend credits | | comfy-cloud-axi generate <model> "<prompt>" --type video --confirm | Video generation | | comfy-cloud-axi generate <model> "<prompt>" --aspect-ratio 16:9 --confirm | With aspect ratio |

Job Tracking

| Command | Description | |---|---| | comfy-cloud-axi job status <prompt_id> | Point-in-time status snapshot | | comfy-cloud-axi job wait <prompt_id> | Block until ready (preferred over polling) | | comfy-cloud-axi job cancel <prompt_id> | Cancel a pending or running job | | comfy-cloud-axi job chain <prompt_id> | Make output available as input for the next workflow | | comfy-cloud-axi job batch <batch_id> | Check status of all jobs in a batch |

Workflows

| Command | Description | |---|---| | comfy-cloud-axi workflow list | List saved workflows in the workspace | | comfy-cloud-axi workflow submit <file> | Submit a workflow JSON → returns prompt_id | | comfy-cloud-axi workflow run <filename-or-uuid> | Run a saved workflow | | comfy-cloud-axi workflow run <filename> --confirm | Run with credit spend approved | | comfy-cloud-axi workflow output <prompt_id> | Retrieve output URLs |

Batch Jobs

| Command | Description | |---|---| | comfy-cloud-axi batch submit <file> | Submit a batch JSON → returns batch_id | | comfy-cloud-axi batch wait <batch_id> | Block until all jobs terminal | | comfy-cloud-axi batch output <batch_id> | Retrieve all ready outputs |

Templates

| Command | Description | |---|---| | comfy-cloud-axi templates <query> | Search templates | | comfy-cloud-axi templates run <name> | Run template → returns prompt_id | | comfy-cloud-axi templates run <name> --confirm | Run with credit spend approved |

Resources

| Command | Description | |---|---| | comfy-cloud-axi nodes <query> | Search ComfyUI nodes | | comfy-cloud-axi nodes <query> --api-only | Partner / API-backed nodes only | | comfy-cloud-axi models <query> | Search ComfyUI model library (checkpoints, LoRAs, etc.) | | comfy-cloud-axi upload <file> | Upload an image | | comfy-cloud-axi queue | Show account-wide queue status | | comfy-cloud-axi usage | Workspace spend report | | comfy-cloud-axi usage --group-by product --months 3 | Spend grouped by product, last 3 months |

Partner Models

22 partner models are reachable via generate. Run comfy-cloud-axi guide partner for the authoritative live list with per-provider routing notes.

Image

| Slug | Description | |---|---| | bfl/flux-2-pro | Text-to-image, up to 9 reference images | | bfl/flux-pro-1.1-ultra | Text-to-image, aspect ratios 1:4 to 4:1 | | bfl/flux-kontext-pro | Image editing from a prompt | | openai/images-generations | OpenAI gen/edit — variant via params.model | | vertexai/nano-banana-2 | Google Gemini 3.1 Flash Image | | vertexai/nano-banana-pro | Google Gemini 3 Pro Image | | xai/grok-image-generate | xAI Grok Imagine | | ideogram/generate | Ideogram text-to-image or edit | | byteplus/images-generations | ByteDance Seedream — variant via params.model |

Video

| Slug | Description | |---|---| | bfl/flux-3-video | BFL FLUX 3 Video + audio | | byteplus/seedance-2.0-t2v | ByteDance Seedance — tier via params.model | | kling/kling-v3-t2v | Kling V3 | | minimax/hailuo-03-t2v | MiniMax Hailuo 03 (H3) | | veo/veo-3-t2v | Google Veo 3 — tier via params.model |

Audio

| Slug | Description | |---|---| | elevenlabs/sound-generation | ElevenLabs sound effect from text |

SVG, 3D, and music use templates run instead (e.g. api_recraft_v4_text_to_vector, api_hunyuan3d_text_to_model).

Workflows

Quick generation (partner model)

guide partner → pick slug
estimate template <name> → confirm cost (optional)
generate <slug> "<prompt>" → spend request (no charge)
generate <slug> "<prompt>" --confirm → prompt_id
job wait <prompt_id> → workflow output <prompt_id>

ComfyUI workflow

workflow list → workflow run <name> [--confirm]
job wait <prompt_id> → workflow output <prompt_id>

Template

templates <query> → templates run <name> [--confirm]
job wait <prompt_id> → workflow output <prompt_id>

Batch

batch submit <file> → batch_id
batch wait <batch_id> (repeat if timed_out: true)
batch output <batch_id>

Chain workflows

workflow run first.json → job wait → job chain <prompt_id>
workflow submit next.json → job wait → workflow output

All commands that spend credits are spend-gated: run without --confirm first to see the cost, then re-run with --confirm after the user agrees.

Development

pnpm install
pnpm run build
pnpm test
pnpm run dev

License

MIT