Nano Banana 2.1 图像编辑
google/nano-banana-2.1/edit
Google 图像编辑,支持最多 14 张参考图、1K–4K 输出,按 token 用量结算。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| images *输入图片 | image_upload | — | image/png,image/jpeg,image/webp · 1–14 items | 上传 1 到 14 张图片进行编辑或作为参考(官方上限 14 张)。支持 png / jpeg / webp,公网 URL 或 base64 data URL。 |
| prompt *提示词 | textarea | — | ≤ 5000 chars | 描述您希望如何编辑图片:改什么、保留什么、风格如何。多张图片时可用「第一张」「第二张」指代。图中需要出现的文字请用引号标出。 |
| aspect_ratio宽高比 | select | — | 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | … | 选择输出图片的宽高比。如果不指定,将跟随输入图片。 |
| resolution分辨率 | select | 1k | 1k | 2k | 4k | 选择输出图片的长边分辨率。分辨率越高细节越多,消耗越多、耗时越长。 |
| thinking_level推理强度 | select | medium | minimal | medium | high | 控制模型生成前的推理量。强度越高,构图与细节越好,但耗时更长。 |
| enable_web_search联网搜索 | boolean | false | — | 允许模型按提示词需要进行搜索。开启选项不固定加费,本接口按返回的 token 用量结算。 |
| enable_image_search图像搜索 | boolean | false | — | 允许模型按提示词需要进行搜索。开启选项不固定加费,本接口按返回的 token 用量结算。 |
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| text | string | |
| images | array<string> |
API
通过统一 REST API 调用本模型;在 API Keys 页获取密钥。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": "https://example.com/input.jpg",
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": false,
"enable_image_search": false
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit",
headers=HEADERS,
json={
"input": {
"images": "https://example.com/input.jpg",
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": False,
"enable_image_search": False
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"images": "https://example.com/input.jpg",
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": false,
"enable_image_search": false
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);文档
Nano Banana 2.1 图像编辑
通过文字指令编辑图片,支持 1–14 张参考图。
输入参数
| 参数 | 必填 | 类型、限制与默认值 |
|---|---|---|
images | 是 | array;1–14 个公网图片 URL 或 base64 data URL;支持 PNG/JPEG/WebP。 |
prompt | 是 | string;最多 5,000 字符。 |
aspect_ratio | 否 | string;不传时跟随输入图片。 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9 |
resolution | 否 | string; 1k / 2k / 4k; default: 1k. |
thinking_level | 否 | string;minimal / medium / high;默认 medium。 |
enable_web_search | 否 | boolean;默认 false。允许按需搜索,是否实际使用由模型判断。 |
enable_image_search | 否 | boolean;默认 false。允许按需搜索,是否实际使用由模型判断。 |
Token 定价
| 计量项 | 美元 / 百万 token | 积分 / 百万 token |
|---|---|---|
| 输入(文本及参考图片) | $1.50 | 150 |
| 文本输出及思考 | $7.50 | 750 |
| 图片输出 | $30.00 | 3000 |
采用 Google Standard token 费率;1 美元 = 100 积分。参考图片按输入 token 收费,不按张固定加价。本接口仅按 token 用量结算,搜索开关不触发固定加费。
提交时仅预扣图片部分:1K / 2K / 4K 分别为 3.36 / 5.04 / 11.34 积分;完成后按 token 总费用多退少补。最终金额向上取整至 0.01 积分,账户折扣另算。
API 示例
请将示例图片 URL 替换为您上传的图片。
POST https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/edit
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"prompt": "Change the background to a quiet bookstore. Preserve the subject.",
"resolution": "1k",
"thinking_level": "medium",
"images": [
"https://example.com/input.png"
]
}
}
GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
提交一次,再用返回的 task_uuid 查询。完成后 output.images 为图片 URL 数组;output.text 可能包含附带文字。
相关模型
xAI Grok Imagine Image v2.0 图片编辑
xAI Grok Imagine Image V2.0 Edit 可根据文本提示词对输入图片进行编辑,并支持可配置的分辨率和质量,适用于精细图片编辑、视觉优化、创意变体、社交内容、营销素材和生产工作流。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
qwen-image-edit-spicy
通过文本指令精确编辑图片,可添加、移除或修改画面元素,也支持风格迁移和背景替换,适合照片修饰与视觉设计。
Qwen Image 3.0 Pro Edit|快速图片编辑
Qwen Image 3.0 Pro Edit 是一款专业级图片编辑模型,具备出色的画质和高级指令理解能力。最高支持 2k。提供开箱即用的 REST inference API,性能优异,无冷启动,价格实惠。
OpenAI GPT Image 2.5 Sunburst 图像编辑
使用最多 16 张参考图片完成高保真、精确的图像编辑。
OpenAI GPT Image 2.5 Flare 图像编辑
使用自然语言指令和最多 16 张参考图片进行快速、均衡的图像编辑。
图片换头
将照片中的人物头部替换为参考图中的头部。先上传目标照片,再上传头部参考图。
Nano Banana 图像编辑
高性价比智能修图。 无需蒙版即可实现物体替换与风格迁移,极速响应,成本低廉。
Nano Banana Pro 图像编辑
4K 语义级修图。基于自然语言修改现有图像,支持智能光影融合与图像内多语言文字编辑。