| name | gemini-image-skill |
| description | Generate document and slide images with Google Gemini or Imagen models, including style selection, aspect ratios, and approval workflow guidance. |
Gemini Image Generation Skill
Google Gemini API를 사용한 이미지 생성 스킬. 슬라이드 및 문서용 이미지를 생성합니다.
Purpose
Gemini 2.0 Flash 또는 Imagen 3 모델을 사용하여 문서/슬라이드에 필요한 이미지를 생성합니다. 해상도와 종횡비 선택을 지원하며, 사용자 승인 워크플로우를 포함합니다.
When to Use This Skill
- "Gemini로 이미지 생성해줘"
- "슬라이드용 그림을 Gemini API로 만들어줘"
- "프레젠테이션에 넣을 일러스트 생성"
- 무료 티어 이미지 생성이 필요할 때 (Gemini 2.0 Flash)
- 특정 종횡비가 필요할 때 (16:9, 9:16 등)
Environment Setup
export GEMINI_API_KEY="your-api-key"
pip install google-genai Pillow
Workflow
Phase 1: Analysis
- 대상 문서/슬라이드 읽기
- 이미지가 필요한 섹션/슬라이드 식별
- 각 섹션의 핵심 컨셉 추출
Phase 2: Style & Configuration Selection
스타일 옵션:
| # | 스타일 | 설명 | 적합한 용도 |
|---|
| 1 | Infographic (기본) | 레이블/텍스트 포함, dense | 문서, 발표 |
| 2 | Technical Diagram | 깔끔한 선, 플로우차트 | 기술 문서 |
| 3 | Vibrant Modern Cartoon | 밝은 그라데이션, 플랫 | 비즈니스, 교육 |
| 4 | Professional Minimalist | 절제된 색상, 기하학 | 공식 발표 |
| 5 | Bold Graphic | 고대비, 팝아트 | 마케팅 |
| 6 | Custom | 사용자 지정 | 자유 |
기본값: Infographic 스타일 (텍스트/레이블 포함)
모델 선택:
| 모델 | 비용 | 특징 |
|---|
| gemini-3-pro-image-preview | $0.06/장 | 기본값, 한글 완벽, 최고 품질 |
| gemini-2.5-flash-image | $0.039/장 | 종횡비 지원, 빠름 |
| gemini-2.0-flash-exp | 무료 | 빠름, 반복용 (한글 깨짐) |
| imagen-4.0-generate-001 | $0.03/장 | Imagen 4.0, 고품질 |
종횡비 옵션: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 21:9
슬라이드용: --aspect-ratio 16:9 (기본 모델이 gemini-3-pro-image-preview)
Phase 3: Image Generation
python3 "generate_gemini_image.py" \
"[상세 설명]" \
--output-path "[경로]" \
--style "[스타일]" \
--model "[모델]" \
--aspect-ratio "[종횡비]" \
--auto-approve
Phase 4: Integration
슬라이드:
문서:
Style Descriptions for Script
| 스타일 | --style 값 |
|---|
| Infographic (기본) | "clean infographic with labeled sections, icons, and visual hierarchy" |
| Technical Diagram | "technical diagram with flowchart elements, arrows, and labeled components" |
| Vibrant Modern Cartoon | "vibrant modern minimalist cartoon illustration" |
| Professional Minimalist | "professional minimalist illustration with muted colors and clean geometric shapes" |
| Bold Graphic | "bold graphic illustration with high contrast colors and strong geometric shapes" |
프롬프트 작성 팁:
- ✅ "4단계 프로세스를 보여주는 인포그래픽, 각 단계에 아이콘과 레이블"
- ✅ "비교 차트: A vs B, 장단점 표시"
- ❌ "두 사람이 연결된 추상적 일러스트" (의미 전달 어려움)
File Naming Convention
슬라이드: [slide-topic-slug].png
- 예:
ai-changes-game.png, team-collaboration.png
- 위치: 슬라이드와 같은
_files_/ 디렉토리
문서: [section-number]-[topic-slug].png
- 예:
01-introduction.png, 03-methodology.png
Cost Estimation
생성 전 비용 안내:
- Gemini 2.0 Flash: 무료
- Imagen 3: $0.03/장
- 예: "10장 생성 시 $0.30 (Imagen 3 기준)"
Error Handling
| 에러 | 해결 방법 |
|---|
| API 키 없음 | GEMINI_API_KEY 환경변수 설정 |
| 안전 필터 차단 | 프롬프트 수정 후 재시도 |
| 모델 미지원 | 사용 가능한 모델로 변경 |
| 네트워크 오류 | 재시도 |
Example Invocation
기본 사용
python3 generate_gemini_image.py "AI 지식 노동자가 책상에서 작업하는 모습" \
--output-path "_files_/knowledge-worker.png"
16:9 슬라이드용 (권장)
python3 generate_gemini_image.py "팀 협업 미팅" \
--output-path "_files_/team-meeting.png" \
--model "gemini-2.5-flash-image" \
--aspect-ratio "16:9" \
--style "professional minimalist illustration"
고품질 이미지 (Imagen 4.0)
python3 generate_gemini_image.py "제품 쇼케이스" \
--output-path "_files_/product.png" \
--model "imagen-4.0-generate-001"
배치 처리 (자동 승인)
python3 generate_gemini_image.py "혁신 컨셉" \
--output-path "_files_/innovation.png" \
--auto-approve
Best Practices
- 인포그래픽 스타일 선호: 텍스트/레이블 포함된 dense한 정보 시각화
- 스타일 일관성: 같은 문서/슬라이드 내에서 동일 스타일 유지
- 상세한 프롬프트: 구체적인 시각적 메타포와 컨셉 포함
- 배치 생성: 모든 이미지 먼저 생성 후 일괄 삽입
- 비용 확인: 생성 전 예상 비용 확인
⚠️ 피해야 할 것: 추상적인 일러스트 (예: 사람들이 연결된 모호한 그림)
✅ 선호: 다이어그램, 플로우차트, 레이블이 있는 인포그래픽
Comparison with DALL-E Skill
| 기능 | DALL-E | Gemini |
|---|
| 무료 티어 | X | O (Flash) |
| 종횡비 | 정사각형만 | 5가지 옵션 |
| 출력 포맷 | JPEG | PNG/JPEG |
| 비용 | $0.04 | $0~$0.03 |
선택 기준:
- DALL-E: 검증된 품질, 기존 워크플로우
- Gemini: 무료 옵션 필요, 다양한 종횡비 필요
