Skip to main content
POST
Playground
填入你的 API Key 和提示詞,然後傳送。這裡打的是線上介面,和你程式碼裡調的是同一個。
從這個頁面發出的請求是真實的,會計入你的 Key。 一張 1K 圖按模型不同約 $0.02–0.09。這裡沒有沙箱,也沒有 mock。

參數

string
必填
用哪個模型。接受 gemini-3-pro-imagegemini-3.1-flash-image, 精確匹配——沒有別名,也不接受 -preview 字尾。
object
必填
生成參數。下面沒列出的鍵一律以 invalid_params 拒絕。
string
任務結束後把結果 POST 到這個地址,省掉輪詢。必須是 https, 其他形式在提交時就會被拒。

會返回什麼

提交立刻返回,一秒都用不到。圖片不在這個響應裡——生成是在後臺進行的。

然後輪詢取圖

這個 Playground 只覆蓋建立呼叫。拿上面響應裡的 id 去讀任務, 直到 status 變成 completedfailed——一張 1K 圖大約 15–40 秒。
完成的任務帶一個 outputs 陣列,裡面是圖片 URL:
產物 URL 不鑑權,並且在任務建立 24 小時後失效。下載時要帶 User-Agent—— 分發 CDN 對不帶這個頭的請求直接返回 403

下一步

概覽

這個系列的全部參數、解析度檔位與實測時延。

非同步任務 API

輪詢閉環、回撥,以及完整錯誤表。