如何使用 Nano Banana 2.1 图像编辑 API:图生图接入指南(2026)

2 min · 更新于 2026-07-11 · NamiFusion 团队

Nano Banana 2.1 图像编辑 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。

Nano Banana 2.1 图像编辑 是一款图生图模型(由 Google 提供):Google 图像编辑,支持最多 14 张参考图、1K–4K 输出,按 token 用量结算。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.0336。

TL;DR

· 任务类型:图生图,由 Google 提供

· 价格:典型一次调用约 $0.0336($1 = 100 积分),按量计费无订阅

· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入

· 可调参数:7 个(见下方参数表)

· 无平台水印,商用可用(遵守服务条款)

用 Nano Banana 2.1 图像编辑 能做什么?

社媒配图与封面:按帖子主题批量出图,统一风格后直接排期发布。

电商与广告素材:产品场景图、Banner 底图、A/B 测试的多版本视觉。

概念设计与灵感探索:角色、场景、风格板,用低成本快速迭代方向。

内容工作流串联:生成结果可直接作为图生视频或换脸的输入素材。

怎么调用这个 API?

  1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
  2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
  3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
提交任务
# 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"

有哪些参数?

images(输入图片):必填

prompt(提示词):必填

aspect_ratio(宽高比):可选

resolution(分辨率):可选,默认 "1k"

thinking_level(推理强度):可选,默认 "medium"

enable_web_search(联网搜索):可选,默认 false

enable_image_search(图像搜索):可选,默认 false

Nano Banana 2.1 图像编辑 的提示词怎么写?

  1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
  2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
  3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
  4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。

价格是多少?

按次积分计价,典型一次调用约 $0.0336($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。

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 官方定价

常见问题

可以先免费试用吗?+

注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。

生成内容可以商用吗?有水印吗?+

可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。

内容政策是什么?+

色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许,详见服务条款。

Nano Banana 2.1 图像编辑 的任务要跑多久?+

取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。

分辨率/时长上限是多少?+

以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。