Nano Banana 이미지 생성과 크기
모델 ID와 엔드포인트 선택은 Nano Banana 개요를 참고하십시오.
요점비율은
aspectRatio로, 해상도는 imageSize로 지정하며, 둘 다 generationConfig.imageConfig 안에 넣습니다.이미지 생성 예시
Python
nano_banana.py
import base64
from google import genai
from google.genai import types
client = genai.Client(
api_key="YOUR_OFOX_API_KEY",
http_options={"api_version": "v1beta", "base_url": "https://api.ofox.io/gemini"},
)
resp = client.models.generate_content(
model="google/gemini-3.1-flash-image",
contents="흰 테이블 위에 놓인 빨간 사과 하나",
config=types.GenerateContentConfig(
response_modalities=["IMAGE"],
image_config=types.ImageConfig(aspect_ratio="16:9", image_size="2K"),
),
)
for part in resp.candidates[0].content.parts:
if part.inline_data:
with open("output.png", "wb") as f:
f.write(part.inline_data.data)Python SDK가 반환하는 inline_data.data는 바이너리 데이터이므로 그대로 파일에 쓸 수 있습니다. cURL은 base64 문자열을 반환하므로 먼저 디코딩해야 합니다.
모델별 허용 값
자주 쓰는 비율 10가지: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. 목록에 없는 비율(예: 5:3)은 400 Request contains an invalid argument가 반환됩니다.
해상도 표기: imageSize는 Google 공식 문서와 같이 대문자 1K, 2K, 4K를 권장합니다. OfoxAI 실측에서는 소문자도 허용되었습니다. 512 단계에는 단위 K를 붙이지 않습니다.
imageConfig를 생략하면: 모델이 비율을 결정합니다. 고정된 비율이 필요하면 명시적으로 전달하십시오.
실측 출력 크기
4K PNG는 약 16 MB이며, base64로 인코딩하면 응답 본문이 20 MB를 넘습니다. 클라이언트, 프록시, 로그 시스템이 큰 응답을 잘라내지 않는지 확인하십시오.
오류가 발생하면 오류 해결을 참고하십시오.
마지막 업데이트