Skip to main content

背景必讀

特點:本分組為內測,可輸出的圖片為 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 分組

編輯使用者資訊:在「額外可見分組」中新增 NB-OSS

2

新建令牌:選擇 NB-OSS 分組

新建令牌時,計費模式選「按次計費」,分組選 NB-OSS(Nano Banana PRO,輸出圖片為 URL,替代 Base64)。只換令牌,請求方式不變。
建立令牌介面:計費模式選擇按次計費,選擇分組 NB-OSS,輸出圖片為 URL 替代 Base64

建立令牌:計費模式選「按次計費」,分組選 NB-OSS(1x)——輸出圖片為 URL,替代 Base64

3

替換令牌,進行測試

替換令牌進行測試。程式碼層面需要相容 URL 輸出的解析 —— 不要直接替換 Base64,兩者相容最佳。

示例程式碼

輸出示例

text 欄位裡有圖片的地址,下方的 thoughtSignature 是推理過程的 base64。
API 響應 JSON 示例,text 欄位包含圖片 URL 地址,thoughtSignature 欄位為推理的 base64

響應 JSON:candidates → content → parts,圖片 URL 在 text 欄位中;thoughtSignature 為推理的 base64

OSS 儲存節點與下載速度

圖片儲存在哪裡?

輸出的圖片 URL 儲存在阿里雲 OSS 洛杉磯節點(美西 us-west-1,北美區域),URL 形如:
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 轉義符 反斜槓 u0026 還原成 & 號,忽略 thoughtSignature 後的 base64 內容

圖片連結在 text 欄位裡;將 JSON 轉義的 & 還原成網址裡的 &,忽略 thoughtSignature 後的 base64