Skip to main content
Mage for ComfyUI is an open-source custom node pack, comfyui-mage, that runs Mage’s image, video, and audio models from your ComfyUI workflows. The models run on Mage’s servers, so the nodes need no GPU and no model downloads. Each run spends Gems from the Mage account whose API key you set.
The nodes are in beta at 0.x, so their inputs may still change.

​
Install

  1. Open ComfyUI-Manager and select Custom Nodes Manager.
  2. Search for Mage and select Install.
  3. Restart ComfyUI when asked.
The nodes depend on the Python SDK, mage-space, and on packages ComfyUI already ships. They need a recent ComfyUI.

​
Add your API key

Create a key in API → API Keys, then do one of the following:
  • Set the MAGE_API_KEY environment variable before starting ComfyUI.
  • Or copy config.ini.example to config.ini in the ComfyUI-Mage folder and paste the key after api_key =.
The environment variable wins when both are set. The key is never stored in your workflows, so you can share them safely.

​
Nodes

The nodes are in the Mage category. Each node also outputs the result’s url. Mage keeps outputs for 30 days, so save anything you want to keep with ComfyUI’s save nodes. The option lists on Mango, Cherry, and Seed Audio come from the API reference, so they match the model pages. A variant may offer fewer values than its family lists; a model refuses a value it does not offer before any Gems are spent.

​
Mage Generate

Mage Generate runs any model in the API. Choose the family in architecture, optionally a variant in model_id, and put the model’s other fields in extra_config as a JSON object, for example:
Connect images for reference images, first_frame and last_frame for models that start or end a video on an image, and video for a source video. A model that takes no such input refuses it before anything is uploaded. Only the output that matches what the model makes carries a value: a node connected to a different one stops with a message naming the output to use instead.

​
Costs and caching

  • Every run spends Gems at the model’s listed price. The node shows the request’s status and the Gems it cost while it runs.
  • The seed is fixed by default, so queueing the same inputs again reuses ComfyUI’s cached output instead of paying for a new run. Change the seed, or set it to randomize, when you want a variation.
  • Stopping the queue cancels every Mage request the workflow started, including one whose submission was still being answered. Cancelled runs are not refunded.
  • A request your balance cannot cover, or a value the model does not offer, fails the node with the API’s message before any Gems are spent.

​
Characters and references

Mention your saved characters and references by @handle in any prompt, exactly as on mage.space. See Characters and references.

​
Troubleshooting

​
Privacy

Images and videos you connect to a node are uploaded to Mage storage and deleted after 30 days, like the outputs. The nodes send nothing else and collect no telemetry.

​
Source

The nodes are MIT-licensed on GitHub and published to the Comfy Registry.

Python SDK

The client the nodes are built on.

Models

Every model with its fields, options, and price.
Last modified on September 30, 2026