Skip to main content
POST
中國大陸用戶請注意: 請使用 https://toapis.cn 作為 Base URL. 將以下範例中的 https://toapis.com 替換為 https://toapis.cn.

模型選擇

兩個模型使用相同的接口和請求參數, 僅透過 model 欄位切換. 支援文生圖和圖生圖. 請求非同步執行, 提交成功後透過任務 ID 查詢結果.
image_urls 只接收公開可存取的圖片 URL, 不接收 base64 資料. 請先使用 上傳圖片接口 上傳本機圖片並取得 URL.

認證

string
必填
所有請求均需要 Bearer Token. 請在 API Key 管理頁面 取得 API Key.

請求參數

string
預設值:"gemini-nano-banana-2.1"
必填
模型名稱. 使用 gemini-nano-banana-2.1 或 gemini-nano-banana-2.1-vip.
string
必填
圖像生成或編輯的文字描述.
string
輸出圖像的寬高比. 支援以下值:
  • 1:1
  • 3:2, 2:3
  • 4:3, 3:4
  • 16:9, 9:16
  • 5:4, 4:5
  • 21:9
  • 1:4, 4:1
  • 1:8, 8:1
integer
預設值:1
輸出數量固定為數字 1, 不要使用字串 "1".
string[]
參考圖片 URL 字串陣列, 用於圖生圖或圖像編輯. 最多 14 張圖片, 每個 URL 必須公開可存取. 參考圖數量不代表輸出圖片數量.單張圖片不超過 10MB. 支援 .jpeg, .jpg, .png, .webp.
object
額外設定參數.

回應欄位

string
任務 ID, 用於查詢任務狀態和結果.
string
固定為 generation.task.
string
請求中使用的模型 ID.
string
任務狀態: queued, in_progress, completed, failed.
integer
任務進度百分比, 範圍為 0-100.
integer
任務建立時間, Unix 時間戳記, 單位為秒.
object
任務中繼資料.

查詢結果

提交回應中的 id 是任務 ID. 使用 圖片任務查詢接口 取得任務狀態和最終圖片. 非同步通知請參考 Webhook 回調.