Nano Banana OSS 分组

Nano Banana OSS（NB-OSS）内测分组：图片输出为 URL 地址而非 Base64，减轻传输压力、提升体验，适合直接使用 URL 的场景。

​

背景必读

特点：本分组为内测，可输出的图片为 URL 地址，而非 Base64，可减轻 Base64 传输压力，提升客户体验。适合直接用 URL 的场景。如果没有特别需求、能处理 Base64 输出的图片格式，则仍然建议使用「正常默认分组」或「NanoBanana 企业分组」。

支持模型（Nano Banana Pro 和第一代）：

• gemini-3-pro-image-preview
• gemini-3.1-flash-image-preview
• gemini-2.5-flash-image

​

如何开始

1. 联系管理员开通该可见分组

   联系管理员为你的账号开通 NB-OSS 可见分组（在「编辑用户信息 → 额外可见分组」中添加 NB-OSS）。

   

   编辑用户信息：在「额外可见分组」中添加 NB-OSS

2. 新建令牌：选择 NB-OSS 分组

   新建令牌时，计费模式选「按次计费」，分组选 NB-OSS（Nano Banana PRO，输出图片为 URL，替代 Base64）。只换令牌，请求方式不变。

   

   创建令牌：计费模式选「按次计费」，分组选 NB-OSS（1x）——输出图片为 URL，替代 Base64

3. 替换令牌，进行测试

   替换令牌进行测试。代码层面需要兼容 URL 输出的解析 —— 不要直接替换 Base64，两者兼容最佳。

​

示例代码

curl --location 'https://api.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent' \
  --header 'Authorization: Bearer sk-' \
  --header 'Content-Type: application/json' \
  --data '{
      "contents": [
          {
              "parts": [
                  {
                      "fileData": {
                          "fileUri": "https://raw.githubusercontent.com/apiyi-api/ai-api-code-samples/refs/heads/main/Vision-API-OpenAI/otter.png",
                          "mimeType": "image/png"
                      }
                  },
                  {
                      "text": "add five dogs"
                  }
              ],
              "role": "user"
          }
      ],
      "generationConfig": {"responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }},
      "safetySettings": []
  }'   > output.json

​

输出示例

在 text 字段里有图片的地址，下方的 thoughtSignature 是推理过程的 base64。

响应 JSON：candidates → content → parts，图片 URL 在 text 字段中；thoughtSignature 为推理的 base64

​

OSS 存储节点与下载速度

​

图片存储在哪里？

输出的图片 URL 存储在阿里云 OSS 洛杉矶节点（美西 us-west-1，北美区域），URL 形如：

https://<bucket名>.oss-us-west-1.aliyuncs.com/xxxx.png

URL 的二级域名（<bucket名> 部分，如 mycdn-gg）可能会变化，请不要在代码或防火墙规则中写死完整域名。如需做域名判断或白名单，请匹配后缀 oss-us-west-1.aliyuncs.com（阿里云 OSS 官方域名），或更宽松地放行 *.aliyuncs.com。

​

下载慢怎么办？

由于存储节点在北美，从中国大陆等地直连下载时速度可能受限，常见原因和建议：

• 公司网络对海外流量限速 / 白名单拦截：请联系网络管理员对 *.oss-us-west-1.aliyuncs.com（或 *.aliyuncs.com）解除限速、加入白名单。
• 及时转存：拿到 URL 后建议尽快下载并转存到自己的存储 / CDN，再分发给终端用户，不要把 OSS URL 直接长期暴露给最终用户。
• 服务器代下：如果本地网络下载慢，可以用海外或网络出口较好的服务器先下载再中转。

更多网络链路排查思路（DNS、路由、跨境带宽等），可参考 FAQ：下载 CDN 图片/视频很慢怎么办？

​

网址打不开？

核心是把输出内容 JSON 里的转义字符 \u0026 还原成正常的 &，同时忽略 thoughtSignature 后面的 base64 内容。

图片链接在 text 字段里；将 JSON 转义的 & 还原成网址里的 &，忽略 thoughtSignature 后的 base64