-preview 字尾的名字也不接受。
系列裡的模型共用同一套請求形狀，所以換模型就是改 model 一個詞。
系列總覽
預設選 Nano Banana 2：它在每個解析度上都明顯更快，參數又完全一樣，
換過去不用改任何整合程式碼。只有當那點額外品質值得每張圖多花十秒左右時，
才換成 Nano Banana Pro。
參數
所有參數都在input 裡。外層信封——model、input、callback_url——
見非同步任務 API。
下面五個欄位就是全集。input 裡出現任何其他鍵都會被 invalid_params 拒掉，
所以拼錯欄位名會立刻報錯，不會被靜默忽略。
解析度檔位
image_size 縮放的是整幅畫面，而不是把某一條邊釘死，所以寬幅圖在 4K 下
長邊遠超 4096 畫素。實測，兩個可用模型完全一致：
檔案體積隨之變化：
1K 約 0.4–0.7 MB，2K 約 2.4–3.0 MB，4K 約 7.5–8.2 MB。
產物一律是帶 C2PA 內容憑證清單的 JPEG。
畫幅比例
接受十個值。gemini-3-pro-image 在 1K 下的實測畫素：
每種比例都落在標稱值的 1％ 以內。不傳
aspect_ratio 時，純文生圖得到
1024 × 1024；傳了 images 則跟隨參考圖的形狀。
圖生圖與多圖合成
在images 裡傳參考圖就是編輯或合成。每一項要麼是 https URL，
要麼是 base64 data URI——裸 base64 字串會被拒，http 也會被拒。
aspect_ratio、image_size、n 同樣生效
——在 4K 下做編輯，產出確實是 4096 × 4096。
URL 是在任務被受理之後由服務端去取的，所以壞的參考圖不會報 400，
而是讓任務變成 failed。兩個錯誤碼告訴你是哪一層放棄的：
兩者都發生在任何模型計算之前，所以失敗很快，重試成本也低。
時延
非同步資料來自 30 個任務、併發 12 的壓測，同步資料來自單次呼叫。 這些數字用來判斷量級，不是服務等級承諾。
非同步多花約 0.9 秒的往返，換來的是剩下 20–40 秒不用掛著連線。壓測下排隊
0–11 秒，已經計入上面的端到端數字。
同步介面形態
三種同步形態對兩個可用模型都有效，且都把圖片放在響應體裡，不給 URL：下一步
Playground
直接在頁面裡發一次真實請求，看任務跑完。
非同步任務 API
信封、輪詢閉環、回撥與錯誤表。