At a glance
The Mage API runs 15 image models, 12 video models, and 1 audio model 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.
15
Image models
12
Video models
1
Audio models
1
API 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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, in three quality tiers | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | Crisp, readable text, up to 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL with faces and hands fixed | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
| 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, minimax-h3 | 30 Gems ($0.03) |
| Plum | Sound on every clip, up to 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Characters brought to life from a first frame | raspberry | 360 Gems ($0.36) |
| 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 |
|---|---|---|---|
| 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, so any Mage account with Gems can call it.
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.
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.