Mage API · Image model
Mango API
Our flagship image family
POST https://api.mage.space/v1/mango/generateAt a glance
The Mango API runs Mango 4 and 5 other variants through Mage at POST https://api.mage.space/v1/mango/generate. A request at the default settings costs 42 Gems (about $0.042), with no subscription. Mango takes saved characters, references by @handle in the prompt.
- ImageOutput
- 6Variants
- 42Gems per image, default
- $0.042About, in USD
Overview
What the Mango API does
Our image family for consistent characters, precise edits, and scenes merged from many references or Characters. Mango 4 leads the family, with the most lifelike light and skin and the sharpest small text; Mango 3 Turbo drafts at a flat price, references included, and Mango 3S reaches 3K.
Mage's flagship image family, for consistent characters, precise edits, and scenes merged from many references. Mango 4 (`mango-v4`) is the default and the newest, with the most lifelike light and skin and the sharpest small text; Mango 3 (`mango-v3`) is the previous flagship; Mango 3 Turbo (`mango-v3-turbo`) drafts at a flat price, references included, and Mango 3S (`mango-v3s`) reaches 3K.
It accepts image, additional_images as inputs.
Quick start
Call the Mango API
Set MAGE_API_KEY, submit to /mango/generate, and poll status_url until the request completes.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
print(request["result"]["url"])Models
Mango model_id values
Send model_id to pick a variant. A request without one runs the default.
| model_id | Name | Default |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | |
| mango-v3-turbo | Mango 3 Turbo | |
| mango-v4 | Mango 4 | Yes |
Options
Mango 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, 3K, 4K |
Inputs
Media inputs Mango accepts
Send each as an https URL, a data URL, or an upload of up to 100 MB.
| Field | Role |
|---|---|
| image | The reference image. |
| additional_images | Additional reference images. |
More image models
Other image generation APIs on Mage
MiniMax H3 Image API
Native 16-megapixel images, open weights
MOSS-Image API
Long prompts and bilingual text, open weights
Nano Banana 2 API
Crisp, readable text, up to 4K
SDXL Plus API
SDXL with faces and hands fixed
Seedream API
Seedream, with a strict filter
Stable Diffusion v1.5 API
The classic, on a budget
FAQ
Frequently asked questions
How much does the Mango API cost?
What is the Mango API endpoint?
Which Mango models can I call?
Does Mango support reference images or characters?
Can I use Mango from Claude or ChatGPT?
How long are Mango results kept?
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.