Nano Banana Pro Preview · 画像編集

POST/v1/images/edits

リクエストパラメータ

Authorization

Header に Authorization を追加し、値は Bearer の後に API キーを続けます。

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"
}

{  "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"

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>"
    }
  ]
}

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

Nano Banana Pro Preview · 画像編集

リクエストパラメータ

リクエストコード例

レスポンス

On this page