Skip to main content
POST
文生图:根据文本描述生成图片
右側的互動式 Playground 支援下拉選擇引數(寬高比、響應型別等)。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),即可一鍵傳送請求測試。
場景說明:本頁用於「文本生成圖片」。只需輸入提示詞即可,無需上傳任何圖片。如需根據現有圖片做編輯,請使用 圖片編輯介面
🖥️ 瀏覽器 Playground 限制(重要)本介面的響應裡包含 base64 編碼的圖片(inlineData.data,數 MB 量級)。受瀏覽器渲染限制,右側 Playground 在收到響應後可能彈出 請求時發生錯誤: unable to complete request ——實際請求已經成功,只是瀏覽器無法把這麼長的 base64 顯示出來。推薦做法(小白零踩坑):
  • 直接複製下方”程式碼示例”中的 Python / Node.js / cURL 到本地執行,程式碼會自動 base64.b64decode 並把圖片儲存為本地檔案
  • Nano Banana 2 Lite 專注 1K 畫布,響應體量適中,但仍建議本地執行以穩妥儲存圖片。
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。請為本模型設定足夠大的 timeout,詳見 圖片 API 呼叫須知與最佳實踐

程式碼示例

Python

cURL

Node.js

OpenAI 相容模式

引數說明速查

詳細的引數文件、可選值和預設值請檢視右側 Playground 中的欄位說明,所有 enum 型別欄位(如 aspectRatio)都支援下拉選擇,無需手動輸入。
從 Nano Banana 2 遷移:只需把模型名從 gemini-3.1-flash-image 改為 gemini-3.1-flash-lite-image,其它引數保持不變。注意 Lite 僅支援 1K 解析度,如傳入 2K/4K 請改回 1K

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
contents
object[]
必填

内容数组,包含文本提示词

generationConfig
object
必填

回應

成功生成图片

candidates
object[]

生成结果数组

usageMetadata
object