Nano Banana 2 이미지 생성 및 편집
Google의 Nano Banana 2 API(Gemini 3.1 Flash Image)를 사용하여 새 이미지를 생성하거나 기존 이미지를 편집합니다.
사용법
절대 경로를 사용하여 스크립트를 실행하세요(스킬 디렉토리로 cd하지 마세요):
새 이미지 생성:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "이미지 설명" --filename "출력-이름.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
기존 이미지 편집:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "편집 지시사항" --filename "출력-이름.png" --input-image "입력/경로/이미지.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
중요: 항상 사용자의 현재 작업 디렉토리에서 실행하여 이미지가 스킬 디렉토리가 아닌 사용자가 작업 중인 위치에 저장되도록 하세요.
기본 워크플로우 (초안 → 반복 → 최종)
목표: 프롬프트가 확정되기 전까지 4K에서 시간을 낭비하지 않고 빠르게 반복합니다.
- 초안 (1K): 빠른 피드백 루프
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<초안 프롬프트>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K
- 반복: 프롬프트를 작은 차이로 조정하고, 실행마다 새 파일명을 유지하세요.
- 편집 시: 만족할 때까지 매 반복마다 동일한
--input-image를 유지하세요.
- 편집 시: 만족할 때까지 매 반복마다 동일한
- 최종 (4K): 프롬프트가 확정된 경우에만 사용
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<최종 프롬프트>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K
해상도 옵션
Gemini 3.1 Flash Image API는 다음 출력 크기 값을 지원합니다:
- 512 - 소형 ~512px급 해상도
- 1K (기본값) - ~1024px 해상도
- 2K - ~2048px 해상도
- 4K - ~4096px 해상도
사용자 요청을 API 매개변수에 매핑:
- "512", "512px", "0.5K", "썸네일", "작게" →
512 - 해상도 언급 없음 →
1K - "저해상도", "1080", "1080p", "1K" →
1K - "2K", "2048", "보통", "중간 해상도" →
2K - "고해상도", "고해상", "Hi-Res", "4K", "울트라" →
4K
API 키
스크립트는 다음 순서로 API 키를 확인합니다:
--api-key인자 (사용자가 채팅에서 키를 제공한 경우 사용)GEMINI_API_KEY환경 변수
둘 중 하나도 없으면 스크립트가 오류 메시지와 함께 종료됩니다.
사전 점검 + 일반적인 오류 (빠른 수정)
-
사전 점검:
command -v uv(존재해야 함)test -n "$GEMINI_API_KEY"(또는--api-key전달)- 편집 시:
test -f "입력/경로/이미지.png"
-
일반적인 오류:
Error: No API key provided.→GEMINI_API_KEY를 설정하거나--api-key를 전달하세요.Error loading input image:→ 잘못된 경로 또는 읽을 수 없는 파일입니다.--input-image가 실제 이미지를 가리키는지 확인하세요.- "quota/permission/403" 스타일 API 오류 → 잘못된 키, 접근 권한 없음 또는 할당량 초과입니다. 다른 키/계정을 시도해보세요.
파일명 생성
패턴: yyyy-mm-dd-hh-mm-ss-name.png 형식으로 파일명을 생성합니다.
형식: {타임스탬프}-{설명적인-이름}.png
- 타임스탬프: 현재 날짜/시간을
yyyy-mm-dd-hh-mm-ss형식(24시간제) - 이름: 하이픈으로 연결된 소문자 설명 텍스트
- 설명 부분은 간결하게 유지하세요(보통 1~5단어).
- 사용자의 프롬프트나 대화 내용에서 맥락을 사용하세요.
- 명확하지 않은 경우 무작위 식별자를 사용하세요(예:
x9k2,a7b3).
예시:
- 프롬프트 "조용한 일본식 정원" →
2025-11-23-14-23-05-japanese-garden.png - 프롬프트 "산 위의 일몰" →
2025-11-23-15-30-12-sunset-mountains.png - 프롬프트 "로봇 이미지 생성" →
2025-11-23-16-45-33-robot.png - 맥락 불명확 →
2025-11-23-17-12-48-x9k2.png
이미지 편집
사용자가 기존 이미지를 수정하려는 경우:
- 이미지 경로를 제공했는지 또는 현재 디렉토리의 이미지를 참조하는지 확인하세요.
--input-image매개변수에 이미지 경로를 사용하세요.- 프롬프트에는 편집 지시사항이 포함되어야 합니다(예: "하늘을 더 극적으로", "사람 제거", "만화 스타일로 변경").
- 일반적인 편집 작업: 요소 추가/제거, 스타일 변경, 색상 조정, 배경 흐리게 처리 등.
프롬프트 처리
생성 시: 사용자의 이미지 설명을 그대로 --prompt에 전달하세요. 명확히 부족한 경우에만 다시 작성하세요.
편집 시: 편집 지시사항을 --prompt에 전달하세요(예: "하늘에 무지개 추가", "수채화 그림처럼 보이게").
두 경우 모두 사용자의 창의적 의도를 유지하세요.
프롬프트 템플릿 (높은 적중률)
사용자가 모호하거나 편집이 정확해야 하는 경우 템플릿을 사용하세요.
-
생성 템플릿:
- "<주제> 이미지를 생성하세요. 스타일: <스타일>. 구도: <카메라/샷>. 조명: <조명>. 배경: <배경>. 색상 팔레트: <팔레트>. 피할 것: <목록>."
-
편집 템플릿 (나머지는 유지):
- "변경: <단일 변경>만 수행하세요. 동일하게 유지: 주제, 구도/크롭, 자세, 조명, 색상 팔레트, 배경, 텍스트 및 전체 스타일. 새 객체를 추가하지 마세요. 텍스트가 있으면 변경하지 않고 유지하세요."
출력
- PNG를 현재 디렉토리(또는 파일명에 디렉토리가 포함된 경우 지정된 경로)에 저장합니다.
- 스크립트는 생성된 이미지의 전체 경로를 출력합니다.
- 이미지를 다시 읽지 마세요 - 사용자에게 저장된 경로만 알려주세요.
예시
새 이미지 생성:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "벚꽃이 핀 조용한 일본식 정원" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K
기존 이미지 편집:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "폭풍 구름으로 하늘을 더 극적으로 만들어줘" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K