跳至主要内容

Mage API · 模型

37 个生成模型,一个 API

Mage API 运行的所有图像、视频和音频模型,包括各自的擅长方向、model_id 值以及默认设置下的价格。

POST https://api.mage.space/v1/{model}/generate

一览

Mage API 在 https://api.mage.space/v1/{model}/generate 提供 18 个图片模型、15 个视频模型和 4 个音频模型。所有模型使用相同的密钥、请求流程和字段名称,并按每次生成用 Gems 付费。

  • 18图像模型
  • 15视频模型
  • 4音频模型
  • 1一个 API 密钥通用

图像模型

图像生成模型

价格按每次生成计算,以 Gems 计价。标准包 1,000 Gems 售价 $1,更大的套餐还会赠送额外 Gems。价格取决于模型、分辨率和时长;此处显示的是默认设置下的价格,每个响应都会在 billing.gems_charged 中给出实际扣费。生成失败会退还 Gems;因 Mage 内容政策被拦截的则不退还。

模型最适合model_id 取值默认价格
Anima专为动漫打造anima-v120 Gems ($0.02)
Chroma开放权重,基于 Flux 构建chroma-v1-hd35 Gems ($0.035)
Flux 2长提示词和多参考图编辑flux2-dev40 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-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine,两种规格grok-imagine-image, grok-imagine-image-2.090 Gems ($0.09)
Guava以假乱真的照片级写实guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDream快速多能,支持负面提示词hidream-fast20 Gems ($0.02)
Krea 2几秒钟生成惊艳美图krea-2-turbo20 Gems ($0.02)
Mango我们的旗舰图片系列mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v442 Gems ($0.042)
MiniMax H3 Image原生 1600 万像素图像,开放权重minimax-h3-image15 Gems ($0.015)
MOSS-Image支持长提示词和中英双语文字,开放权重moss-image25 Gems ($0.025)
Nano Banana 2文字清晰锐利,最高 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL Plus修复了面部和手部的 SDXL6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
SeedreamSeedream,带严格过滤seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.542 Gems ($0.042)
Stable Diffusion v1.5经典之选,经济实惠15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 Large最听话的 Stable Diffusionsd-3-5-large10 Gems ($0.01)
Stable Diffusion XL针对照片级写实调优的 SDXL6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageMage 上最快的图片模型z-image-turbo10 Gems ($0.01)

视频模型

视频生成模型

模型最适合model_id 取值默认价格
Berry忠实还原参考素材的视频berry, berry-2189 Gems ($0.189)
Blueberry锁定首帧和尾帧blueberry, blueberry-v2360 Gems ($0.36)
Cherry我们的旗舰视频系列cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok Video动起来的 Grok Imaginegrok-imagine-video375 Gems ($0.375)
Kiwi日常视频,无需任何设置kiwi270 Gems ($0.27)
Lemon功能齐全的视频,价格更亲民lemon245 Gems ($0.245)
LTX Video适合快速迭代的开放权重视频模型ltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
Magejutsu重新演绎任意视频,保留原有动作magejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
Melon动起来的动漫,可选配音频melon, melon-pro147 Gems ($0.147)
MiniMax-H3带立体声的快速开源视频minimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
Plum每个片段都有声音,最高 2Kplum, plum-max, plum-fast173 Gems ($0.173)
Raspberry从首帧让角色动起来raspberry360 Gems ($0.36)
SeedanceSeedance,内容过滤严格seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0,内容过滤严格wan-3.0245 Gems ($0.245)
Wan Video v2.2提供 Lightning 版本的开放权重视频模型wan22-video, wan22-video-lightning40 Gems ($0.04)

音频模型

音频生成模型

模型最适合model_id 取值默认价格
Eleven MusicElevenLabs 歌曲,可带人声或纯音乐eleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4:可自由掌控的逼真语音eleven-v430 Gems ($0.03)
MiniMax Music 3根据你的歌词生成完整歌曲,开放权重minimax-music-3125 Gems ($0.125)
Seed Audio一条提示词生成人声、音乐和音效seed-audio-1.019 Gems ($0.019)

常见问题

常见问题解答

Mage API 的费用是多少?
没有订阅,也没有月费。每次生成按对应模型的标价以 Gems 支付,标准包中 1,000 Gems 售价 $1。每个模型页面都会列出默认设置下的价格,每次响应也会返回实际扣费金额。生成失败会退还 Gems;因违反 Mage 内容政策而被拦截的则不予退还。如果你的余额不足以支付某次请求,该请求会在扣费前被拒绝。
使用 API 需要 Mage 会员吗?
不能。API 只能使用 Gems。会员套餐及其应用内无限生成不适用于 API 请求。账号需要先成功付款一次,购买任意 Gem 包或套餐均可;注册赠送的 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 余额,畅用所有模型。按生成量付费,用多少付多少。

Characters社区