Mage API · Models
35 generation models, one API
Every image, video, and audio model the Mage API runs, with what each is best for, its model_id values, and its price at default settings.
POST https://api.mage.space/v1/{model}/generateAt a glance
The Mage API runs 17 image models, 15 video models, and 3 audio models at https://api.mage.space/v1/{model}/generate. Every model uses the same key, request lifecycle, and field names, and is paid per generation in Gems.
- 17Image models
- 15Video models
- 3Audio models
- 1API key for all
Image models
Image generation models
Prices are per generation, in Gems. 1,000 Gems cost $1 on the standard pack, and larger packs add bonus Gems. The price depends on the model, resolution, and duration; the default-settings price is shown, and every response reports the exact charge in billing.gems_charged. A generation that fails is refunded; one Mage's content policy blocks is not.
| Model | Best for | model_id values | Default price |
|---|---|---|---|
| Anima | Purpose-built for anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, built on Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Long prompts and multi-reference edits | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Precise prompts and readable text | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, in two tiers | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Photorealism that passes for a photograph | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Fast and versatile, with negative prompts | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Gorgeous aesthetics in seconds | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Our flagship image family | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MOSS-Image | Long prompts and bilingual text, open weights | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Crisp, readable text, up to 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL with faces and hands fixed | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, with a strict filter | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | The classic, on a budget | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | The Stable Diffusion that listens best | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | Photoreal-tuned SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | The fastest image model on Mage | z-image-turbo | 10 Gems ($0.01) |
Video models
Video generation models
| Model | Best for | model_id values | Default price |
|---|---|---|---|
| Berry | Video that stays true to your references | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Pin the first and last frame | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Our flagship video family | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, in motion | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Everyday video, zero setup | kiwi | 270 Gems ($0.27) |
| Lemon | Every video feature, at a friendlier price | lemon | 245 Gems ($0.245) |
| LTX Video | Fast open-weights video for iteration | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Recast any video, keeping its motion | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime in motion, with optional audio | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Fast open video with stereo sound | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Sound on every clip, up to 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Characters brought to life from a first frame | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, with a strict filter | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, with a strict filter | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Open-weights video with a Lightning variant | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Audio models
Audio generation models
| Model | Best for | model_id values | Default price |
|---|---|---|---|
| Eleven Music | ElevenLabs songs, with vocals or without | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: lifelike speech you can direct | eleven-v4 | 30 Gems ($0.03) |
| Seed Audio | Voices, music, and sound effects from one prompt | seed-audio-1.0 | 19 Gems ($0.019) |
FAQ
Frequently asked questions
How much does the Mage API cost?
There is no subscription or monthly fee. Each generation is paid in Gems at its model's listed price, and 1,000 Gems cost $1 on the standard pack. Every model page lists its default-settings price, and each response reports the exact charge. A generation that fails is refunded; one Mage's content policy blocks is not. A request your balance cannot cover is refused before anything is charged.
Do I need a Mage membership to use the API?
No. The API runs on Gems alone. Membership plans and their unlimited in-app generation do not apply to API requests. The account needs one successful payment first, any Gem pack or plan; signup bonus Gems work in the Mage app only.
Can I use API outputs commercially?
Yes. Content you create with Mage, including through the API and MCP server, can be used commercially. Attribution is appreciated but not required.
What are the rate limits?
An account can have 20 generations queued or running at once. A submit past that is refused with 429 and costs nothing. Write to [email protected] to raise the cap for your use case.
Can my AI agent use the Mage API?
Yes. Agents can call the REST API with a key, or connect to the Mage MCP server, which gives Claude, ChatGPT, Claude Code, Grok, and Cursor sixteen ready-made tools for choosing a model, quoting the price, generating, and fetching the result. See the MCP server.
Is there an SDK for the Mage API?
Yes. The official @mage-space/sdk package on npm and mage-space on PyPI are open source and typed for every model. They submit, wait for the result, retry safely, and upload files for you. ComfyUI users can install the comfyui-mage node pack. See the Mage SDKs.
I already use another generation API. What do I have to change?
Point your client at https://api.mage.space/v1, send your Mage key as a Bearer token, and map your fields to the model page: prompt, aspect_ratio, resolution, duration, and model_id work the same way across every Mage model. Requests are asynchronous, so submit and then poll status_url.
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.