MaxAPI Gemini Interactions API：文字、圖片與對話狀態
使用 MaxAPI 金鑰呼叫 /v1beta/interactions，從 curl 開始，接收原生串流事件、延續已儲存對話並確認目前功能限制。
技術核對日期:
先完成一次文字請求
向 POST https://api.maxapi.dev/v1beta/interactions 發送請求，在 x-goog-api-key 或 Authorization: Bearer 傳入 MaxAPI 金鑰；亦提供 /v1/interactions。使用 model 與 input，而非 generateContent 的 contents/candidates 格式，從回應讀取原生 steps 與 usage。不需後續查詢的單次呼叫可設定 store:false。
curl https://api.maxapi.dev/v1beta/interactions \
-H "x-goog-api-key: $MAXAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"google/gemini-3.1-flash-lite","input":"Say hello.","store":false}'接收原生串流事件
在 JSON 加入 stream:true，curl 加上 -N。MaxAPI 保留原生 SSE 事件類型與 ID，請勿按 OpenAI Chat Completions 的 chunk 格式解析。終止事件於計費結算後發出，傳入的 Api-Revision 會轉送上游。
保存並延續對話
省略 store 或設為 true 以保存 interaction。保存回傳的 int_… ID，下一次 POST 以 previous_interaction_id 傳入。GET /v1beta/interactions/{id} 可查詢，完成及結算後可對相同路徑 DELETE。只有擁有者可存取；已驗證路由保存 7 天，受上游配額限制，延續對話仍綁定原始渠道及憑證。
生成圖片或提供參考圖
下方 Nano Banana 2.1 圖片生成請求已通過驗證。編輯時將 input 換成文字與圖片陣列，例如 [{"type":"text","text":"Edit the reference"},{"type":"image","mime_type":"image/png","data":"BASE64"}]，使用有效圖片資料並遵守模型參考圖上限。目前已驗證路由回傳原生 inline 圖片資料，並非 OpenAI data[] 結構。
curl https://api.maxapi.dev/v1beta/interactions \
-H "x-goog-api-key: $MAXAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model":"google/gemini-nano-banana-2.1",
"input":"Create a blue circle on a white square.",
"store":false,
"response_format":{"type":"image","image_size":"1K","aspect_ratio":"1:1"},
"generation_config":{"max_output_tokens":8192}
}'確認支援功能範圍
2026-10-12 正式環境驗證涵蓋 Gemini 3 Flash Preview、3.1 Flash Lite、3.1 Pro Preview、3.5 Flash 的文字生成，以及 Nano Banana 2.1 圖片生成。仍適用既有模型及路由權限；支援 generateContent 不代表自動支援 Interactions。
目前已驗證路由不支援背景執行、取消、事件重播或代管代理。一般 JSON 輸出可用，但嚴格 response_format.schema 與圖片 URI 交付在驗證中回傳上游錯誤。MaxAPI 保留請求設定並明確回報不支援，不會靜默移除參數。async.maxapi.dev 的圖片任務預設行為不會啟用 Interactions 背景執行。
了解計費及中斷恢復
建立時預留積分，再按原生用量及模型既有價格結算一次；查詢與刪除不會另建生成或計費。若有 X-MaxAPI-Interaction-ID 請保存，以便斷線後查詢已受理、已儲存的 interaction。只有受理前明確的 429／503 拒絕才可能切換渠道，結果不明的逾時不會自動重送。重新建立前請先檢查既有 interaction 或使用紀錄。
各模型參數
這是公開設定快照，不代表即時可用性。參數、支援路由與參考圖限制請查看各模型頁面。
- Gemini 3.1 Flash-Lite
google/gemini-3.1-flash-lite - Nano Banana 2.1
google/gemini-nano-banana-2.1