nano-banana-2 API 国内直连 / 中转教程

nano-banana-2 是 Google 推出的 Gemini 图像模型,出图和改图都很强,尤其擅长多参考图合成(最多 6 张)。它在国内直接调用官方接口通常不方便,而半页酥(byesu)以官方直连渠道中转这个模型,不走逆向、不降智,按张计费,真实单价 $0.025 / 张,分辨率覆盖 1K / 2K / 4K。

本页给你一个能直接复制运行的接入示例。控制台注册在 byesu.com,完整媒体接口文档见 docs.byesu.com/media。

一句话:它是什么,多少钱

• 模型:nano-banana-2(Google Gemini 图像),文生图 + 图生图一体,多参考图合成表现突出
• 单价:$0.025 / 张,按"张"计费,分辨率 1K / 2K / 4K 均以 size 参数表达
• 接入方式:OpenAI 兼容接口,Base URL https://byesu.com/v1,令牌用 media / media-gen 分组

令牌必须选对分组

图片模型的令牌必须属于 media / media-gen 分组,否则会报「无可用渠道」。到 控制台 新建令牌时,在「分组」下拉里选它即可。详见 选择分组。

如何调用

准备:拿一个令牌

1. 打开 控制台 登录 → 左侧 令牌 → 添加令牌
2. 分组选 media / media-gen,起个名、设好额度 → 提交
3. 复制得到形如 sk-xxxxxxxx 的令牌

文生图(curl)

文生图走 POST /v1/images/generations,同步返回 PNG 的 base64:

curl https://byesu.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "黄昏时分,金色麦田里奔跑的金毛猎犬,电影感,浅景深",
    "size": "2048x1152"
  }'

返回:

{ "data": [ { "b64_json": "<base64 字符串>" } ] }

文生图(Python)

import base64, requests

resp = requests.post(
    "https://byesu.com/v1/images/generations",
    headers={"Authorization": "Bearer sk-你的令牌"},
    json={
        "model": "nano-banana-2",
        "prompt": "赛博朋克风格的雨夜街道,霓虹倒影,4K 写实",
        "size": "3840x2160",   # 长边 ≈3840 → 4K
    },
).json()

b64 = resp["data"][0]["b64_json"]
open("out.png", "wb").write(base64.b64decode(b64))

图生图 / 多参考图合成(nano-banana-2 的强项)

图生图走 POST /v1/images/edits,multipart/form-data 格式。参考图作为文件上传,字段名 image 可重复传多张(nano-banana-2 上限 6 张,每张 ≤8MB):

curl https://byesu.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的令牌" \
  -F model="nano-banana-2" \
  -F prompt="把这三张照片里的人物合成到同一个海边场景,统一光线" \
  -F size="2048x2048" \
  -F image=@person1.png \
  -F image=@person2.png \
  -F image=@scene.png

返回格式与文生图相同(data[0].b64_json)。Python 里用 files=[("image", open(p,"rb")) for p in paths] 传多张即可。

关键参数说明

参数	端点	必填	说明
model	两者	✅	固定填 nano-banana-2,大小写与横杠要一致
prompt	两者	✅	提示词,中英文都行;写清主体 + 场景 + 风格 + 光线效果更好
size	两者		宽x高像素,同时决定比例和分辨率档:长边 ≈1024→1K、≈2048→2K、≈3840→4K。如 "1024x1024"(1:1·1K)、"2048x1152"(16:9·2K)、"3840x2160"(16:9·4K)。不传默认 1:1 基础档
image	仅 edits		参考图文件字段,可重复传多张,nano-banana-2 上限 6 张,每张 ≤8MB

计费只看"张数",与分辨率档无关:$0.025 / 张。控制台里能看到每次调用的实际计费价。

为什么用 byesu 接入 nano-banana-2

• 官方直连不降智:走官方渠道中转,不是逆向 / 镜像 / 破解,出图质量与官方一致
• 透明按张计价:nano-banana-2 $0.025 / 张,控制台可见实际计费价与官网划线价,充多少扣多少
• 失败自动退款:媒体任务若生成失败,费用自动退回,不为废图买单
• 多参考图友好:原生支持 /v1/images/edits 多图上传,直接发挥 nano-banana-2 最多 6 张参考图合成的长处
• 一个接口全模型:同一套 OpenAI 兼容接口还能调其他图像 / 视频 / 文本模型,换模型只改 model 字段
• 国内可直连:Base URL https://byesu.com/v1,无需额外代理配置

相关链接

• 媒体接口总览(图片 / 视频 API)
• 图片生成模型与参数
• 快速开始:3 步接入
• 选择分组(建令牌必看)
• 控制台注册 / 创建令牌

常见问题

nano-banana-2 国内能用吗?

能。半页酥(byesu)以官方直连渠道中转 nano-banana-2,Base URL 用 https://byesu.com/v1,国内可直接调用,无需额外代理。令牌选 media / media-gen 分组即可。

nano-banana-2 api 多少钱一张?

半页酥真实单价为 $0.025 / 张,按"张"计费,与分辨率档(1K/2K/4K)无关。生成失败会自动退款,控制台里能看到每次调用的实际计费价。

怎么用 nano-banana-2 做多参考图合成?

调用 POST /v1/images/edits(multipart 格式),把参考图作为文件放在 image 字段,该字段可重复上传多张。nano-banana-2 最多支持 6 张参考图,每张 ≤8MB,非常适合把多个人物/元素合成到同一场景。

能在 Claude Code 或客户端里用 nano-banana-2 吗?

nano-banana-2 是图像生成模型,通过 /v1/images/generations 与 /v1/images/edits 接口调用,不走对话 chat 接口,所以不是在 Claude Code 里当聊天模型用。你可以用 curl/Python 直接调,或在半页酥的生成工作台里选它出图。Claude Code、Codex、Cherry Studio 等客户端接入的是文本/编程模型。

nano-banana-2 支持哪些分辨率和比例?

支持 1K / 2K / 4K 三档,通过 size 参数(宽x高像素)表达:长边约 1024 为 1K、约 2048 为 2K、约 3840 为 4K。常用比例有 1:1、16:9、9:16、4:3、3:4 等,如 2048x1152 就是 16:9 的 2K。

调用 nano-banana-2 报"无可用渠道"怎么办?

几乎都是令牌分组选错了。图片模型的令牌必须属于 media / media-gen 分组。到控制台重新建一个该分组的令牌,并确认 model 填的是 nano-banana-2(大小写、横杠一致)即可解决。