Nano Banana 图片编辑 API（Standard）

​

调用前准备

export LAOZHANG_API_KEY="替换为你的老张API密钥"
python -m pip install requests

• post()：发送带鉴权的请求
• read_image()：读取本地 PNG、JPEG 或 WebP 图片
• save_images()：从返回内容中取出 data URL 并保存为图片

​

编辑一张图片

IMAGE=photo.png   # 替换为你的图片路径

# 生成 data URL，并用 jq 写入请求文件（需要 jq 1.6 及以上）
{ printf 'data:%s;base64,' "$(file --mime-type -b "$IMAGE")"; base64 < "$IMAGE" | tr -d '\n'; } > image-url.txt

jq -n --rawfile url image-url.txt '{
  model: "gemini-2.5-flash-image",
  stream: false,
  messages: [{
    role: "user",
    content: [
      {type: "text", text: "把背景换成浅灰色摄影棚，保留主体的外观、颜色和位置"},
      {type: "image_url", image_url: {url: $url}}
    ]
  }]
}' > standard-edit-request.json

curl --fail-with-body --max-time 300 \
  "https://api.laozhang.ai/v1/chat/completions" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @standard-edit-request.json \
  -o standard-edit.json

python nano_banana.py standard-edit.json standard-edit

import sys

from nano_banana import post, read_image, save_images

MODEL = "gemini-2.5-flash-image"  # 迁移时改为 gemini-3.1-flash-image
MAX_IMAGES = 3                    # Standard 建议不超过 3 张；Nano Banana 2 可改为 14

if not 1 <= len(sys.argv) - 2 <= MAX_IMAGES:
    raise SystemExit(f'用法：python standard_edit.py "编辑指令" 图片1 [图片2 ...]，最多 {MAX_IMAGES} 张')
prompt, paths = sys.argv[1], sys.argv[2:]

content = [{"type": "text", "text": prompt}]
for path in paths:
    mime, data = read_image(path)
    content.append({"type": "image_url", "image_url": {"url": f"data:{mime};base64,{data}"}})

result = post("/v1/chat/completions", {
    "model": MODEL,
    "stream": False,
    "messages": [{"role": "user", "content": content}],
})
save_images(result, "standard-edit")

python standard_edit.py "把背景换成浅灰色摄影棚，保留主体的外观、颜色和位置" photo.png

​

合成多张图片

python standard_edit.py "把第一张图中的杯子放到第二张图的木桌上，保留杯子的颜色和花纹" cup.png table.jpg
python standard_edit.py "让第一张图中的人物穿上第二张图里的外套，背景换成第三张图的街道" person.jpg jacket.png street.jpg

​

使用公网图片 URL

curl --fail-with-body --max-time 300 \
  "https://api.laozhang.ai/v1/chat/completions" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image",
    "stream": false,
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "在天空中加一道彩虹，其余内容保持不变"},
        {"type": "image_url", "image_url": {"url": "https://example.com/your-image.png"}}
      ]
    }]
  }' \
  -o standard-url-edit.json

python nano_banana.py standard-url-edit.json standard-url-edit

​

读取返回结果

{
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "![image](data:image/png;base64,iVBORw0KGgo...)"
    },
    "finish_reason": "stop"
  }]
}

​

编辑指令怎么写

• 先写要改的内容，再写必须保留的内容，例如「把背景换成浅灰色摄影棚，保留人物的姿势、服装和光线方向」。
• 多张图片时按顺序称为第一张图、第二张图，并说明每张图的用途。
• 一次只提一两处修改。复杂的改动分几次完成，把上一次的结果作为下一次的输入。
• 可以直接用中文写指令。

​

迁移到新模型

1. 把请求中的 model 改为目标模型 ID。使用本页的 standard_edit.py 时改 MODEL；迁移到 Nano Banana 2 或 Pro 后，可以把 MAX_IMAGES 调高到 14。
2. 用同样的图片和指令在新模型上各运行一次，检查编辑效果，并在调用日志中核对模型 ID 和扣费。
3. 需要指定比例或 2K、4K 分辨率时，改用 Gemini 原生格式，写法见 Nano Banana 2 API 或 Nano Banana Pro 图片编辑 API。Nano Banana 2 Lite 只输出 1K。

​

常见错误

• 原图或指令触发上游安全策略时，原样重试通常仍被拦截，每次都会扣费。原因与避免方法见避免没有图片的扣费。
• 图片请求耗时较长，客户端超时不代表服务端已停止处理。立即重复提交可能多生成一次，并重复计费。

​

常见问题

​

10 月 2 日之后还能调用 Standard 吗？

• 老张API不保证继续提供的期限，该模型随时可能停止。
• 停止后请求会失败，不会自动转到新模型；它不像 -preview ID 那样映射到正式 ID。

​

编辑时能指定输出比例或 2K、4K 分辨率吗？

• 用 generationConfig.imageConfig.aspectRatio 设置比例，共 10 种，取值见下表。
• 不设置比例时，Google 的默认行为是让输出尺寸跟随输入图片。
• Standard 只输出约 1K，不能传 imageSize。需要 2K、4K 时，迁移到 Nano Banana 2 或 Nano Banana Pro，再加上 imageSize。

​

旧代码里的 -preview 模型 ID 还能用吗？

​

相关文档与来源

• Nano Banana 总览：五个模型对比、共用代码与计费规则
• Nano Banana 2 API：推荐的迁移目标，0.5K–4K、最多 14 张参考图
• Nano Banana 2 Lite API：只需 1K 时的轻量模型
• Nano Banana Pro 图片编辑 API：复杂合成与 4K 输出
• 图像 API 选型与价格：与其他图像模型比较
• Google 弃用页：gemini-2.5-flash-image 的停止日期与替代模型
• Google 图像生成文档：各模型的输入图片数量与迁移建议