gemini-3-pro-imagegen

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: 편집할 입력 이미지

프롬프트 작성 팁

1. 장면 묘사: 키워드 나열 대신 서술형 설명
2. 스타일 명시: "수채화", "3D 렌더링", "미니멀리즘"
3. 조명/구도: "골든아워 조명", "45도 각도에서"
4. 텍스트 포함시: 정확한 문구를 따옴표로 감싸기

워크플로우

1. 프롬프트 준비 → 구체적이고 상세한 설명
2. 설정 선택 → 비율/해상도 결정
3. 이미지 생성 → generate_content 호출
4. 결과 저장 → 반드시 현재 작업 디렉토리(cwd)에 저장. /tmp 사용 금지
5. 파일 공유 → present_files 도구로 전달

출력 경로 규칙 (필수)

• --output 옵션에는 반드시 현재 작업 디렉토리 기준 상대경로 또는 현재 작업 디렉토리의 절대경로를 사용할 것
• /tmp, /var/tmp 등 임시 디렉토리에 저장하지 말 것
• 예시: --output ./generated_image.png 또는 --output cat_infographic.png

참고 자료

• API 상세 정보: references/api_reference.md 참조