一览
Mage API 在 https://api.mage.space/v1/{model}/generate 上提供 15 个图像模型、12 个视频模型和 1 个音频模型。所有模型使用同一个密钥、相同的请求流程和字段名,并按每次生成以 Gems 付费。
15
图像模型
12
视频模型
1
音频模型
1
一个 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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine,分三档画质 | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | 文字清晰锐利,最高 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | 修复了面部和手部的 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
视频模型
视频生成模型
| 模型 | 最适合 | model_id 取值 | 默认价格 |
|---|---|---|---|
| Berry | 忠实还原参考素材的视频 | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | 锁定首帧和尾帧 | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | 我们的旗舰视频系列 | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | 动起来的 Grok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | 日常视频,无需任何设置 | kiwi | 270 Gems ($0.27) |
| Lemon | 功能齐全的视频,价格更亲民 | lemon | 245 Gems ($0.245) |
| LTX Video | 适合快速迭代的开放权重视频模型 | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | 动起来的动漫,可选配音频 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | 带立体声的快速开源视频 | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | 每个片段都有声音,最高 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | 从首帧让角色动起来 | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | 提供 Lightning 版本的开放权重视频模型 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
音频模型
音频生成模型
| 模型 | 最适合 | model_id 取值 | 默认价格 |
|---|---|---|---|
| Seed Audio | 一条提示词生成人声、音乐和音效 | seed-audio-1.0 | 19 Gems ($0.019) |
常见问题
常见问题解答
Mage API 的费用是多少?
没有订阅,也没有月费。每次生成按对应模型的标价以 Gems 支付,标准包中 1,000 Gems 售价 $1。每个模型页面都会列出默认设置下的价格,每次响应也会返回实际扣费金额。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的则不予退还。如果你的余额不足以支付某次请求,该请求会在扣费前被拒绝。
使用 API 需要 Mage 会员吗?
不需要。API 仅使用 Gems。会员方案及其应用内无限生成权益不适用于 API 请求,因此任何有 Gems 的 Mage 账号都可以调用。
API 生成的内容可以商用吗?
可以。你用 Mage 创作的内容(包括通过 API 和 MCP 服务器生成的内容)可用于商业用途。署名我们会很感谢,但不是必须的。
速率限制是多少?
一个账号最多可同时有 20 个生成任务处于排队或运行中。超出后提交会被以 429 拒绝,且不会扣费。如需根据你的使用场景提高上限,请发邮件至 [email protected]。
我的 AI 智能体可以使用 Mage API 吗?
可以。智能体可以使用密钥调用 REST API,也可以连接 Mage MCP 服务器,它为 Claude、ChatGPT、Claude Code、Grok 和 Cursor 提供十六个现成工具,用于选择模型、查询价格、生成内容以及获取结果。详见MCP 服务器。
Mage API 有 SDK 吗?
有。npm 上的官方 @mage-space/sdk 包和 PyPI 上的 mage-space 均为开源,并为每个模型提供了类型定义。它们会替你提交任务、等待结果、安全重试并上传文件。ComfyUI 用户可以安装 comfyui-mage 节点包。详见Mage SDK。
我已经在用其他生成 API 了,需要改哪些地方?
将你的客户端指向 https://api.mage.space/v1,把 Mage 密钥作为 Bearer 令牌发送,并按模型页面映射你的字段:prompt、aspect_ratio、resolution、duration 和 model_id 在所有 Mage 模型中的用法一致。请求是异步的,所以先提交,再轮询 status_url。
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。