No GPU required
Mage runs the models, so a laptop runs the same workflows as a workstation, and nothing needs downloading.
At a glance
Mage for ComfyUI is an open-source custom node pack (comfyui-mage) that runs Mage models from ComfyUI workflows. Install it from ComfyUI-Manager or with "comfy node install comfyui-mage", set a Mage API key, and add the Mage Mango Image, Mage Cherry Video, Mage Seed Audio, or Mage Generate node. Generations run on Mage's servers and are paid in Gems.
4
Nodes
28
Models
0
GPUs needed
MIT
Open source
Setup
How to add Mage to ComfyUI
A Mage account with Gems is required; each run spends Gems from the account whose key you set.
Install the nodes
In ComfyUI-Manager, open the Custom Nodes Manager, search for Mage, and install it. Or use the Comfy CLI.
comfy node install comfyui-mageAdd your API key
Create a key in API → API Keys on mage.space and set it as MAGE_API_KEY before you start ComfyUI, or paste it into config.ini in the ComfyUI-Mage folder. The key never goes into your workflows.
export MAGE_API_KEY="mage_sk_..."Add a Mage node and queue
Find the nodes in the Mage category, connect them like any other node, and queue. Each node shows its progress and the Gems the run cost.
Nodes
The Mage nodes
Each node also outputs the URL of its result, which Mage keeps for 30 days.
| Node | Makes | What it does |
|---|---|---|
| Mage Mango Image | IMAGE | Generate or edit an image with Mango. Connect reference images, or the image to edit. |
| Mage Cherry Video | VIDEO | Generate a video with sound using Cherry. Connect reference images or a source video. |
| Mage Seed Audio | AUDIO | Voices, dialogue, music, or sound effects from one prompt, optionally matched to an image. |
| Mage Generate (any model) | IMAGE, VIDEO, or AUDIO | Every other Mage model. Set its fields as JSON and connect reference images, first and last frames, or a video. |
Why Mage in ComfyUI
Frontier models in your node graph
Every Mage model
Mango for images, Cherry for video, Seed Audio for sound, and all 28 models through Mage Generate.
No paying twice
The seed is fixed by default, so queueing the same inputs again reuses ComfyUI’s cached result instead of starting a new generation.
Stop means stop
Interrupting the queue cancels every Mage request the workflow started. Cancelled runs are not refunded.
Your characters and references
Mention saved characters and references by @handle in the prompt, as on mage.space.
Safe to share
The API key stays in your environment or config file, never in the workflow, and the nodes send no telemetry.
Ideas
Workflows to try
- Generate a product shot with Mage Mango Image, then animate it with Mage Cherry Video.
- Load your own image, restyle it with Mango, and upscale it with your favorite local nodes.
- Make a video with Cherry and a matching soundtrack with Mage Seed Audio in the same graph.
- Run Lemon through Mage Generate with a first and last frame for precise transitions.
- Keep a character consistent across a batch by mentioning its @handle in every prompt.
Models
The models behind the nodes
Image · from 37 Gems
Guava API
Photorealism that passes for a photograph
Image · from 135 Gems
Mango API
Our flagship image family
Video · from 618 Gems
Cherry API
Our flagship video family
Video · from 245 Gems
Lemon API
Every video feature, at a friendlier price
Video · from 338 Gems
Plum API
Sound on every clip, up to 2K
Audio · from 19 Gems
Seed Audio API
Voices, music, and sound effects from one prompt
FAQ
Frequently asked questions
What is Mage for ComfyUI?
An open-source ComfyUI custom node pack, comfyui-mage, that runs Mage's image, video, and audio models from your workflows through the Mage API.
Do I need a GPU to use the Mage nodes?
No. Generations run on Mage’s servers, so the nodes work on any machine that runs ComfyUI, with no model downloads.
How much do the Mage ComfyUI nodes cost?
The nodes are free and MIT-licensed. Each run spends Gems at the model’s listed price, from the account whose API key you set. A cancelled run is not refunded.
How do I install the Mage nodes?
Search for Mage in ComfyUI-Manager, or run "comfy node install comfyui-mage". You can also clone the GitHub repository into ComfyUI/custom_nodes and install its requirements.txt.
Where does the API key go?
Set it as the MAGE_API_KEY environment variable before starting ComfyUI, or put it in config.ini in the ComfyUI-Mage folder. It is never saved in workflows, so you can share them safely.
Which models can I use in ComfyUI?
Every model in the Mage API: Mango, Cherry, and Seed Audio have their own nodes, and Mage Generate runs the other 25, such as Guava, Lemon, Plum, and Nano Banana 2.
Are the Mage SDKs free and open source?
Yes. The SDKs and the ComfyUI nodes are MIT-licensed on GitHub, and installing them is free. You pay only for the generations you run, in Gems, at each model’s listed price.
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.