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 並把圖片儲存為本地檔案
  • 如要在瀏覽器裡試 Playground,把 imageSize 設為最小檔(如 512 / 1K),縮小響應體積。
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。請為本模型設定足夠大的 timeout,詳見 圖片 API 呼叫須知與最佳實踐

程式碼示例

Python

cURL

Node.js

引數說明速查

詳細的引數文件、可選值和預設值請檢視右側 Playground 中的欄位說明,所有 enum 型別欄位(如 aspectRatioimageSizethinkingLevel)都支援下拉選擇,無需手動輸入。
不支援的功能以下谷歌官方功能在 API易 中不支援,需要單獨計費:
  • Grounding with Google Search(谷歌搜尋增強):通過 tools: [{"google_search": {}}] 呼叫即時搜尋資訊
  • Image Search Grounding(圖片搜尋增強,Nano Banana 2 獨有):通過谷歌圖片搜尋獲取視覺上下文
這些功能需要額外的谷歌搜尋 API 費用,暫不納入 API易 轉發範圍。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
contents
object[]
必填

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

generationConfig
object
必填

回應

成功生成图片

candidates
object[]

生成结果数组

usageMetadata
object