Mage API · Image model
Z-Image API
The fastest image model on Mage
POST https://api.mage.space/v1/z_image/generateAt a glance
The Z-Image API runs Z-Image through Mage at POST https://api.mage.space/v1/z_image/generate. A request at the default settings costs 10 Gems (about $0.01), with no subscription. Z-Image takes no @handle mentions.
- ImageOutput
- 1Variant
- 10Gems per image, default
- $0.01About, in USD
Overview
What the Z-Image API does
Blazing fast and easy on Gems. Photoreal text-to-image with solid anatomy and clean lettering, up to 2K; no reference images.
The fastest image model on Mage: photoreal text-to-image with solid anatomy and lettering, at 1K or 2K.
It generates from the prompt alone.
Quick start
Call the Z-Image API
Set MAGE_API_KEY, submit to /z_image/generate, and poll status_url until the request completes.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('z_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'z-image-turbo',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("z_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo",
})
print(request["result"]["url"])Models
Z-Image model_id values
Send model_id to pick a variant. A request without one runs the default.
| model_id | Name | Default |
|---|---|---|
| z-image-turbo | Z-Image | Yes |
Options
Z-Image parameters
Allowed values across all variants; a variant may offer fewer. The docs list the options per variant.
| Field | Values |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
More image models
Other image generation APIs on Mage
Anima API
Purpose-built for anime
Chroma API
Open-weights, built on Flux
Flux 2 API
Long prompts and multi-reference edits
GPT Image 2 API
Precise prompts and readable text
Grok Image API
Grok Imagine, in two tiers
Guava API
Photorealism that passes for a photograph
FAQ
Frequently asked questions
How much does the Z-Image API cost?
What is the Z-Image API endpoint?
Which Z-Image models can I call?
Does Z-Image support reference images or characters?
Can I use Z-Image from Claude or ChatGPT?
How long are Z-Image results kept?
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.