GeminiNano Banana
Nano Banana · 이미지 생성
이미지 / Gemini / Nano Banana / 이미지 생성
POST
/v1/images/generations요청 파라미터
Authorization
Header에 Authorization을 추가하고 값은 Bearer 뒤에 API 키를 붙입니다.
Authorization: Bearer ****************
Header 파라미터
Content-Typestring선택
application/json
Acceptstring선택
application/json
Body 파라미터application/json필수
modelstring필수
모델 ID, `gemini-2.5-flash-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-2.5-flash-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-2.5-flash-image", "prompt": "눈밭을 달리는 골든리트리버", "n": 1, "size": "1024x1024", "response_format": "b64_json" }'응답
200 · 성공
createdinteger선택
생성 타임스탬프(초)
dataarray[object]필수
생성된 이미지
예시
{ "created": 1730000000, "data": [ { "b64_json": "<base64>" } ]}