Introduction

文字

圖片

生成圖片POST編輯圖片POST

影片

1tokens1tokens
開始使用API 參考
GeminiNano Banana Pro Preview

Nano Banana Pro Preview · 編輯圖片

圖片 / Gemini / Nano Banana Pro Preview / 編輯圖片

POST/v1/images/edits

請求參數

Authorization

在 Header 加入參數 Authorization，其值為 Bearer 之後拼接你的 API Key。

Authorization: Bearer ****************
Body 參數multipart/form-data必填
modelstring必需
模型 ID，固定為 `gemini-3-pro-image-preview`
promptstring必需
編輯指令，如把背景改成雪夜
imagefile必需
待編輯圖片；可重複傳多張（`image` 或 `image[]`）
maskfile可選
遮罩圖片，標出要修改的區域
ninteger可選
生成張數，預設 `1`
sizestring可選
解析度，如 `1024x1024`
response_formatstring可選
回傳格式。`url` 僅對支援的模型（如 DALL-E 系列）生效；OpenAI gpt-image 一律回傳 `b64_json` 並忽略此欄位。
範例
{  "model": "gemini-3-pro-image-preview",  "prompt": "把背景改成雪夜",  "image": "dog.png",  "size": "1024x1024"}

請求範例程式碼

curl https://api.hotrouter.ai/v1/images/edits \  -H "Authorization: Bearer $API_KEY" \  -F "model=gemini-3-pro-image-preview" \  -F "prompt=把背景改成雪夜" \  -F "image=@dog.png" \  -F "size=1024x1024"

回應

200 · 成功
createdinteger可選
建立時間戳（秒）
dataarray[object]必需
生成的圖片列表
範例
{  "created": 1730000000,  "data": [    {      "b64_json": "<base64>"    }  ]}

生成圖片POST

Previous Page

生成圖片POST

Next Page

On this page

請求參數請求範例程式碼回應
{
  "model": "gemini-3-pro-image-preview",
  "prompt": "把背景改成雪夜",
  "image": "dog.png",
  "size": "1024x1024"
}
curl https://api.hotrouter.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gemini-3-pro-image-preview" \
  -F "prompt=把背景改成雪夜" \
  -F "image=@dog.png" \
  -F "size=1024x1024"
{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}