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