Mage API · 图片生成
支持全部模型的 AI 图片生成 API
文生图、图像编辑和角色一致性,来自 18 个模型(包括 Mage 旗舰模型 Mango 4),只需一个密钥和一个余额。
POST https://api.mage.space/v1/{model}/generate一览
Mage 图像生成 API 是位于 https://api.mage.space/v1 的 REST API,可运行 18 个文生图和图像编辑模型,包括 Mango 4、Guava 2 Pro、GPT Image 2.6、Nano Banana 2、Flux 2 和 Krea 2。你只需向 /{model}/generate 发送 POST 提示词,轮询请求状态,然后下载图片。每张图片用 Gems 付费,无需订阅。
- 18个图片模型
- $0.009默认设置下最低价,每张图片
- 20并发生成数
- $0月费
模型
Mage API 中的所有图片模型
价格按每次生成计算,以 Gems 计价。标准包 1,000 Gems 售价 $1,更大的套餐还会赠送额外 Gems。价格取决于模型、分辨率和时长;此处显示的是默认设置下的价格,每个响应都会在 billing.gems_charged 中给出实际扣费。生成失败会退还 Gems;因 Mage 内容政策被拦截的则不退还。
| 模型 | 最适合 | model_id 取值 | 默认价格 |
|---|---|---|---|
| Anima | 专为动漫打造 | anima-v1 | 20 Gems ($0.02) |
| Chroma | 开放权重,基于 Flux 构建 | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | 长提示词和多参考图编辑 | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | 精准遵循提示词,文字清晰可读 | 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,两种规格 | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | 以假乱真的照片级写实 | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | 快速多能,支持负面提示词 | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | 几秒钟生成惊艳美图 | krea-2-turbo | 20 Gems ($0.02) |
| Mango | 我们的旗舰图片系列 | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | 原生 1600 万像素图像,开放权重 | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | 支持长提示词和中英双语文字,开放权重 | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | 文字清晰锐利,最高 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | 修复了面部和手部的 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream,带严格过滤 | 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 | 经典之选,经济实惠 | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | 最听话的 Stable Diffusion | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | 针对照片级写实调优的 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Mage 上最快的图片模型 | z-image-turbo | 10 Gems ($0.01) |
快速开始
使用 Anima v1 生成图片
设置 MAGE_API_KEY,提交请求,然后轮询直到完成。把 URL 中的 anima 换成上面任意一个模型即可。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])工作原理
从 API 密钥到成品,只需三次调用
所有模型共用一套认证方式、一套异步请求流程和相同的字段名称。
创建 API 密钥
登录 Mage,打开 API → API Keys 并创建密钥。密钥以 mage_sk_ 开头,只显示一次。每个账号最多可以有 10 个有效密钥。
提交生成任务
携带 Authorization: Bearer 请求头,向 https://api.mage.space/v1/{model}/generate 发送 JSON 格式的 POST 请求。接口会立即返回 request_id、status 和 status_url。请附上 Idempotency-Key 请求头,这样重试时不会重复扣费。
轮询并下载
持续轮询 status_url,直到状态变为 completed、failed 或 cancelled。请求完成后,result.url 会提供图片、视频或音频文件,文件保留 30 天。
为生产环境而生
每个 Mage API 请求都享有
一个密钥,通用所有模型
一个 REST API、一个 Gems 余额,即可使用 37 个图片、视频和音频模型。只需修改 URL 路径就能切换模型。
按生成次数付费
无需订阅,也没有最低消费。你购买 Gems,每次请求按标价扣费。生成失败会退还 Gems,但因违反 Mage 内容政策而被拦截的除外。
安全重试
借助幂等键,重试提交时会返回原始请求,不会重复扣费。
角色保持一致
只需保存一次角色或参考图,之后在任意提示词中写下 @handle,即可在所有支持的模型中使用。
支持大文件输入
可通过 URL 或 data URL 传入图片、视频和音频,也可通过签名上传方式上传最大 100 MB 的文件。
同时处理 20 个生成任务
每个账号可同时运行 20 个生成任务,并可根据你的使用场景提高上限。被拒绝的请求不会扣费。
使用场景
开发者用图片 API 做什么
产品图和营销图片
按需生成产品图、广告变体和社交媒体帖子,借助 GPT Image 2.6 或 Nano Banana 2 还能渲染清晰可读的文字。
角色保持一致
只需保存一次角色,就能在整套图像中保持同一张脸。支持 Mango 4、Guava 2 Pro 以及其他可使用 @handle 提及的模型。
图像编辑流水线
发送原图并附上指令,只修改你指定的内容,其余部分保持不变。
应用与游戏
无需自己部署任何 GPU,就能在产品内生成头像、贴纸、卡片和场景。
写实人像
Guava 2 Pro 能渲染人像、时尚和生活方式照片,肌肤、面料和光线都逼真自然。
大批量快速出稿
Z-Image Turbo 和 Krea 2 价格低廉,适合大批量缩略图和初稿生成。
常见问题
常见问题解答
最好的 AI 图像生成 API 是什么?
图像 API 支持图像编辑和参考图吗?
图像 API 支持哪些分辨率?
Mage API 的费用是多少?
使用 API 需要 Mage 会员吗?
API 生成的内容可以商用吗?
速率限制是多少?
我的 AI 智能体可以使用 Mage API 吗?
Mage API 有 SDK 吗?
我已经在用其他生成 API 了,需要改哪些地方?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。