| name | gemini-3-pro-imagegen |
| description | Google Gemini 이미지 생성/편집 스킬. Nano Banana 2 (gemini-3.1-flash-image-preview), Nano Banana (gemini-3-pro-image-preview), 텍스트-이미지, 이미지 편집, 멀티턴 편집 수행. 사용 시점: AI 이미지 생성, 이미지 편집/수정, 인포그래픽 생성, 로고/스티커 디자인, 제품 목업, 만화/스토리보드, 고해상도(4K) 이미지 필요시. 나노바나나, Gemini 이미지, Google 검색 기반 이미지 생성에 사용. |
Gemini Image Generation
Google Gemini 이미지 생성 모델을 사용한 고품질 이미지 생성 및 편집. (2026-03 기준)
설치
pip install google-genai pillow --break-system-packages
모델 선택
| 모델 | 모델명 | 특징 |
|---|
| Nano Banana Pro | gemini-3-pro-image-preview | 고품질, 4K, 텍스트 렌더링, Thinking |
| Nano Banana 2 | gemini-3.1-flash-image-preview | 최신, Flash 속도 + Pro 품질, 이미지 검색 그라운딩 |
기본 추천: 일반 용도 gemini-3.1-flash-image-preview, 최고 품질 gemini-3-pro-image-preview
기본 사용법
텍스트 → 이미지 생성
from google import genai
from google.genai import types
client = genai.Client()
response = client.models.generate_content(
model="gemini-3-pro-image-preview",
contents="미니멀한 커피숍 로고, 'Morning Brew' 텍스트 포함",
config=types.GenerateContentConfig(
response_modalities=['TEXT', 'IMAGE'],
image_config=types.ImageConfig(
aspect_ratio="1:1",
image_size="2K"
),
)
)
for part in response.parts:
if part.text:
print(part.text)
elif image := part.as_image():
image.save("output.png")
이미지 편집
from PIL import Image
image_input = Image.open('input.png')
response = client.models.generate_content(
model="gemini-3-pro-image-preview",
contents=["이 이미지의 배경을 일몰로 바꿔줘", image_input],
config=types.GenerateContentConfig(
response_modalities=['TEXT', 'IMAGE'],
)
)
멀티턴 편집 (채팅)
chat = client.chats.create(
model="gemini-3-pro-image-preview",
config=types.GenerateContentConfig(
response_modalities=['TEXT', 'IMAGE'],
)
)
response1 = chat.send_message("광합성을 설명하는 인포그래픽 만들어줘")
response2 = chat.send_message("이걸 스페인어로 번역해줘")
설정 옵션
비율 (aspect_ratio)
| 비율 | 용도 |
|---|
1:1 | 정사각형, 프로필, 로고 |
16:9 | 와이드스크린, 프레젠테이션 |
9:16 | 모바일, 스토리/릴스 |
4:3 | 클래식 사진 |
3:4 | 세로 인물 |
21:9 | 시네마틱 |
해상도 (image_size)
| 값 | 설명 |
|---|
1K | 기본값 |
2K | 고해상도 |
4K | 최고 해상도 (Pro, Nano Banana 2 지원) |
고급 기능
Google 검색 그라운딩
실시간 정보 기반 이미지 생성 (모든 모델 지원, Nano Banana 2는 이미지 검색도 지원):
response = client.models.generate_content(
model="gemini-3.1-flash-image-preview",
contents="오늘 서울 날씨를 시각화한 인포그래픽",
config=types.GenerateContentConfig(
response_modalities=['TEXT', 'IMAGE'],
tools=[{"google_search": {}}]
)
)
다중 참조 이미지 (최대 14장)
from PIL import Image
response = client.models.generate_content(
model="gemini-3-pro-image-preview",
contents=[
"이 사람들의 단체 사진을 만들어줘",
Image.open('person1.png'),
Image.open('person2.png'),
Image.open('person3.png'),
],
config=types.GenerateContentConfig(
response_modalities=['TEXT', 'IMAGE'],
image_config=types.ImageConfig(
aspect_ratio="5:4",
image_size="2K"
),
)
)
스크립트 사용
이미지 생성 스크립트 실행:
python scripts/generate_image.py "프롬프트" --ratio 16:9 --size 2K --output output.png
옵션:
--ratio: 비율 (기본: 1:1)--size: 해상도 1K/2K/4K (기본: 1K)--output: 출력 파일명--search: Google 검색 그라운딩 활성화--input: 편집할 입력 이미지
프롬프트 작성 팁
- 장면 묘사: 키워드 나열 대신 서술형 설명
- 스타일 명시: "수채화", "3D 렌더링", "미니멀리즘"
- 조명/구도: "골든아워 조명", "45도 각도에서"
- 텍스트 포함시: 정확한 문구를 따옴표로 감싸기
워크플로우
- 프롬프트 준비 → 구체적이고 상세한 설명
- 설정 선택 → 비율/해상도 결정
- 이미지 생성 →
generate_content 호출
- 결과 저장 → 반드시 현재 작업 디렉토리(cwd)에 저장.
/tmp 사용 금지
- 파일 공유 →
present_files 도구로 전달
출력 경로 규칙 (필수)
--output 옵션에는 반드시 현재 작업 디렉토리 기준 상대경로 또는 현재 작업 디렉토리의 절대경로를 사용할 것/tmp, /var/tmp 등 임시 디렉토리에 저장하지 말 것- 예시:
--output ./generated_image.png 또는 --output cat_infographic.png
참고 자료
- API 상세 정보:
references/api_reference.md 참조
