Nano Banana Pro · 生成圖片

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-pro-image`

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-pro-image",
  "prompt": "一隻在雪地裡奔跑的黃金獵犬",
  "n": 1,
  "size": "1024x1024",
  "response_format": "b64_json"
}

{  "model": "gemini-3-pro-image",  "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-pro-image",
    "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-pro-image",    "prompt": "一隻在雪地裡奔跑的黃金獵犬",    "n": 1,    "size": "1024x1024",    "response_format": "b64_json"  }'

回應

200 · 成功

createdinteger可選

建立時間戳（秒）

dataarray[object]必需

生成的圖片列表

範例

{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}

{  "created": 1730000000,  "data": [    {      "b64_json": "<base64>"    }  ]}

Nano Banana Pro · 生成圖片

請求參數

請求範例程式碼

回應

On this page