Skip to content
PlaygroundDocsGet API key

Mage for ComfyUI

Mage models as ComfyUI nodes

Generate images, video, and audio inside your ComfyUI workflows with Mango, Cherry, Seed Audio, and every other Mage model. No GPU and no model downloads.

Set up ComfyUI on MageOpen in the Comfy RegistrySource on GitHub
comfy node install comfyui-mage

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.

  • 4Nodes
  • 37Models
  • 0GPUs needed
  • MITOpen 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.

  1. 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-mage

  2. Add 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_..."

  3. 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.

NodeMakesWhat it does
Mage Mango ImageIMAGEGenerate or edit an image with Mango. Connect reference images, or the image to edit.
Mage Cherry VideoVIDEOGenerate a video with sound using Cherry. Connect reference images or a source video.
Mage Seed AudioAUDIOVoices, dialogue, music, or sound effects from one prompt, optionally matched to an image.
Mage Generate (any model)IMAGE, VIDEO, or AUDIOEvery 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

  • No GPU required

    Mage runs the models, so a laptop runs the same workflows as a workstation, and nothing needs downloading.

  • Every Mage model

    Mango for images, Cherry for video, Seed Audio for sound, and all 37 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 42 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 173 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 34, 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.

Set up ComfyUI on MageOpen in the Comfy Registry
CharactersCommunity