Mage API · 图像模型
Nano Banana 2 API
文字清晰易读,最高支持 4K
POST https://api.mage.space/v1/nano_banana_v2/generate一览
Nano Banana 2 API 通过 Mage 运行 Nano Banana 2.1 及另外 1 个版本,接口为 POST https://api.mage.space/v1/nano_banana_v2/generate。使用默认设置的一次请求消耗 51 Gems(约 $0.051),无需订阅。Nano Banana 2 支持已保存的角色,在提示词中通过 @handle 引用即可。
- 图像输出
- 2变体
- 51默认每张图片所需 Gems
- $0.051约合美元
概览
Nano Banana 2 API 能做什么
Google 推出的图像模型,适合制作带清晰文字的图形和营销内容。Nano Banana 2.1 是该系列的主力;两个模型都能根据最多 14 张参考图生成或编辑图片,分辨率最高 4K。适用 Google 的安全过滤。
Google 的 Nano Banana 模型,适合制作带可读文字的图形,并可根据最多 14 张参考图进行编辑,最高 4K。默认的 Nano Banana 2.1(`nano-banana-v2.1`)价格更低;Nano Banana 2(`nano-banana-v2`)还支持 512 分辨率输出。适用 Google 的安全过滤。
支持的输入:image、additional_images。
快速开始
调用 Nano Banana 2 API
设置 MAGE_API_KEY,向 /nano_banana_v2/generate 提交请求,然后轮询 status_url,直到请求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/nano_banana_v2/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "nano-banana-v2.1"
}' | 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('nano_banana_v2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'nano-banana-v2.1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("nano_banana_v2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "nano-banana-v2.1",
})
print(request["result"]["url"])模型
Nano Banana 2 的 model_id 取值
传入 model_id 即可选择变体。未指定时将使用默认变体。
| model_id | 名称 | 默认 |
|---|---|---|
| nano-banana-v2 | Nano Banana 2 | |
| nano-banana-v2.1 | Nano Banana 2.1 | 是 |
选项
Nano Banana 2 参数
以下为所有变体允许的取值,个别变体可选项可能更少。文档中列出了各变体的选项。
| 字段 | 取值 |
|---|---|
| aspect_ratio | 1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 |
| resolution | 512, 1K, 2K, 4K |
输入
Nano Banana 2 支持的媒体输入
可通过 https 链接、data URL 或不超过 100 MB 的上传文件发送。
| 字段 | 用途 |
|---|---|
| image | 参考图片。 |
| additional_images | 额外的参考图片。 |
更多图像模型
Mage 上的其他图像生成 API
SDXL Plus API
修复了面部和手部的 SDXL
Seedream API
Seedream,带严格过滤
Stable Diffusion v1.5 API
经典之选,经济实惠
Stable Diffusion v3.5 Large API
最听话的 Stable Diffusion
Stable Diffusion XL API
针对写实效果调优的 SDXL
Z-Image API
Mage 上速度最快的图像模型
常见问题
常见问题解答
Nano Banana 2 API 的价格是多少?
Nano Banana 2 API 的端点是什么?
可以调用哪些 Nano Banana 2 模型?
Nano Banana 2 支持参考图片或角色吗?
可以在 Claude 或 ChatGPT 中使用 Nano Banana 2 吗?
Nano Banana 2 的生成结果会保留多久?
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。