Mage API · 图像模型
Mango API
我们的旗舰图像模型系列
POST https://api.mage.space/v1/mango/generate一览
Mango API 通过 Mage 运行 Mango 4 及其他 5 个版本,接口为 POST https://api.mage.space/v1/mango/generate。使用默认设置发起一次请求需 42 Gems(约 $0.042),无需订阅。Mango 支持在提示词中通过 @handle 调用已保存的角色和参考图。
- 图像输出
- 6变体
- 42默认每张图片所需 Gems
- $0.042约合美元
概览
Mango API 能做什么
我们的图像模型系列,适合保持角色一致、精准编辑,以及融合多张参考图或 Characters 的场景。Mango 4 是系列中的领头型号,光线和肌肤最逼真,小字也最清晰;Mango 3 Turbo 以统一价格快速出草稿,参考图也包含在内;Mango 3S 最高可达 3K。
Mage 的旗舰图像模型系列,适合保持角色一致、精准编辑,以及融合多张参考图的场景。Mango 4(`mango-v4`)是默认的最新版本,光线和肌肤最逼真,小字也最清晰;Mango 3(`mango-v3`)是上一代旗舰;Mango 3 Turbo(`mango-v3-turbo`)以统一价格快速出草稿,参考图也包含在内;Mango 3S(`mango-v3s`)最高可达 3K。
支持的输入:image、additional_images。
快速开始
调用 Mango API
设置 MAGE_API_KEY,向 /mango/generate 提交请求,然后轮询 status_url,直到请求完成。
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"])模型
Mango 的 model_id 取值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | |
| mango-v3-turbo | Mango 3 Turbo | |
| mango-v4 | Mango 4 | 是 |
选项
Mango 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| 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 |
输入
Mango 支持的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
更多图像模型
Mage 上的其他图像生成 API
MiniMax H3 Image API
原生 1600 万像素图像,开放权重
MOSS-Image API
支持长提示词和中英双语文字,开放权重
Nano Banana 2 API
文字锐利清晰,最高支持 4K
SDXL Plus API
修复了面部和手部的 SDXL
Seedream API
Seedream,带严格过滤
Stable Diffusion v1.5 API
经典之选,经济实惠
常见问题
常见问题解答
Mango API 的价格是多少?
Mango API 的端点是什么?
我可以调用哪些 Mango 模型?
Mango 支持参考图片或角色吗?
我可以在 Claude 或 ChatGPT 中使用 Mango 吗?
Mango 的生成结果会保存多久?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。