GeminiNano Banana Pro Preview
Nano Banana Pro Preview · 이미지 편집
이미지 / Gemini / 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"}요청 코드 예시
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>" } ]}