GeminiNano Banana 2 Preview
Nano Banana 2 Preview · 生成圖片
圖片 / Gemini / Nano Banana 2 Preview / 生成圖片
POST
/v1/images/generations請求參數
Authorization
在 Header 加入參數 Authorization，其值為 Bearer 之後拼接你的 API Key。
Authorization: Bearer ****************
Header 參數
Content-Typestring可選
application/json
Acceptstring可選
application/json
Body 參數application/json必填
modelstring必需
模型 ID，固定為 `gemini-3.1-flash-image-preview`
promptstring必需
圖像描述
ninteger可選
生成張數，預設 `1`
sizestring可選
解析度，如 `1024x1024`
qualitystring可選
品質檔位（模型支援時）
response_formatstring可選
回傳格式。`url` 僅對支援的模型（如 DALL-E 系列）生效；OpenAI gpt-image 一律回傳 `b64_json` 並忽略此欄位。
output_formatstring可選
輸出圖像編碼格式（png / jpeg / webp）；對 OpenAI gpt-image 模型生效。
output_compressioninteger可選
壓縮等級 0–100；僅 jpeg / webp 生效。
backgroundstring可選
背景類型（transparent / opaque / auto）；transparent 需搭配 png 或 webp。
moderationstring可選
內容審核嚴格度（auto / low）；仍由上游審核。
userstring可選
用戶端可選傳入的最終使用者識別碼，用於上游濫用偵測。
範例
{ "model": "gemini-3.1-flash-image-preview", "prompt": "一隻在雪地裡奔跑的黃金獵犬", "n": 1, "size": "1024x1024", "response_format": "b64_json"}請求範例程式碼
curl https://api.hotrouter.ai/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3.1-flash-image-preview", "prompt": "一隻在雪地裡奔跑的黃金獵犬", "n": 1, "size": "1024x1024", "response_format": "b64_json" }'回應
200 · 成功
createdinteger可選
建立時間戳（秒）
dataarray[object]必需
生成的圖片列表
範例
{ "created": 1730000000, "data": [ { "b64_json": "<base64>" } ]}