Nano Banana 2.1 图像编辑

google/nano-banana-2.1/edit

Google 图像编辑,支持最多 14 张参考图、1K–4K 输出,按 token 用量结算。

示例

Nano Banana 2.1 图像编辑 示例 1

参数

名称类型默认约束说明
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分辨率select1k1k | 2k | 4k选择输出图片的长边分辨率。分辨率越高细节越多,消耗越多、耗时越长。
thinking_level推理强度selectmediumminimal | medium | high控制模型生成前的推理量。强度越高,构图与细节越好,但耗时更长。
enable_web_search联网搜索booleanfalse—允许模型按提示词需要进行搜索。开启选项不固定加费,本接口按返回的 token 用量结算。
enable_image_search图像搜索booleanfalse—允许模型按提示词需要进行搜索。开启选项不固定加费,本接口按返回的 token 用量结算。

输出字段

字段类型说明
textstring
imagesarray<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.50150
文本输出及思考$7.50750
图片输出$30.003000

采用 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 可能包含附带文字。

Google 官方定价

相关模型

xAI Grok Imagine Image v2.0 图片编辑
图生图X Ai

xAI Grok Imagine Image v2.0 图片编辑

xAI Grok Imagine Image V2.0 Edit 可根据文本提示词对输入图片进行编辑,并支持可配置的分辨率和质量,适用于精细图片编辑、视觉优化、创意变体、社交内容、营销素材和生产工作流。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。

起 $0.090 / 每次
qwen-image-edit-spicy
图生图

qwen-image-edit-spicy

通过文本指令精确编辑图片,可添加、移除或修改画面元素,也支持风格迁移和背景替换,适合照片修饰与视觉设计。

起 $0.034 / 每次
Qwen Image 3.0 Pro Edit|快速图片编辑
图生图Qwen Image 3.0 Pro

Qwen Image 3.0 Pro Edit|快速图片编辑

Qwen Image 3.0 Pro Edit 是一款专业级图片编辑模型,具备出色的画质和高级指令理解能力。最高支持 2k。提供开箱即用的 REST inference API,性能优异,无冷启动,价格实惠。

起 $0.0663 / 每次
OpenAI GPT Image 2.5 Sunburst 图像编辑
图生图OpenAI

OpenAI GPT Image 2.5 Sunburst 图像编辑

使用最多 16 张参考图片完成高保真、精确的图像编辑。

起 $0.220 / 每次
OpenAI GPT Image 2.5 Flare 图像编辑
图生图OpenAI

OpenAI GPT Image 2.5 Flare 图像编辑

使用自然语言指令和最多 16 张参考图片进行快速、均衡的图像编辑。

起 $0.220 / 每次
图生图
图生图NamiFusion

图片换头

将照片中的人物头部替换为参考图中的头部。先上传目标照片,再上传头部参考图。

起 $0.220 / 每次
Nano Banana 图像编辑
图生图Google

Nano Banana 图像编辑

高性价比智能修图。 无需蒙版即可实现物体替换与风格迁移,极速响应,成本低廉。

起 $0.038 / 每次
Nano Banana Pro 图像编辑
图生图Google

Nano Banana Pro 图像编辑

4K 语义级修图。基于自然语言修改现有图像,支持智能光影融合与图像内多语言文字编辑。

起 $0.140 / 每次