Gemini Image Generation

Google Gemini 이미지 생성 모델을 사용한 고품질 이미지 생성 및 편집. (2026-03 기준)

설치

pip install google-genai pillow --break-system-packages

모델 선택

기본 추천: 일반 용도 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)

해상도 (image_size)

고급 기능

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 ./generatedimage.png 또는 --output catinfographic.png

참고 자료

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