nanobanana

nanobanana 스킬 개요

nanobanana는 어떤 용도에 적합한가

nanobanana 스킬은 Google의 gemini-3-pro-image-preview 모델을 감싸는 가벼운 래퍼로, 커맨드라인에서 실용적으로 이미지 생성과 이미지 편집을 할 수 있게 해줍니다. 전체 앱을 먼저 만들지 않고도 이미지를 반복 가능하고 스크립트화된 방식으로 생성하거나, 프롬프트 변형을 테스트하거나, 결과물을 배치로 만들어야 하는 사용자에게 특히 잘 맞습니다.

누가 nanobanana를 설치하면 좋은가

nanobanana skill이 특히 잘 맞는 대상은 다음과 같습니다.

• 이미 Python과 환경 변수를 쓰고 있는 개발자
• 재현 가능한 이미지 생성 명령을 원하는 AI 운영 담당자
• 스타일, 화면비, 출력 크기를 비교하며 프롬프트를 실험하는 사용자
• 텍스트-투-이미지와 기존 이미지 편집 워크플로를 모두 써야 하는 사용자

반대로 채팅 UI에서 가끔 이미지 한두 장만 생성하면 되는 정도라면, 이 스킬은 필요한 것보다 설정이 더 많게 느껴질 수 있습니다.

실제로 해결하려는 일

대부분의 사용자는 추상적으로 "이미지 모델"을 찾는 게 아닙니다. 대략적인 창작 아이디어를 실제로 쓸 수 있는 결과물로 바꾸고 싶어 합니다. 예를 들면 제품 사진, 풍경, 마스코트, 컨셉 일러스트, 혹은 기존 이미지의 수정본 같은 것입니다. nanobanana for Image Generation이 유용한 이유는 이런 작업을 바로 실행할 수 있는 CLI 경로를 제공하기 때문입니다. 프롬프트 입력, 선택적인 원본 이미지 입력, 화면비 선택, 그리고 2K/4K 출력 옵션까지 한 흐름 안에 들어 있습니다.

일반적인 프롬프트 입력과 비교해 nanobanana가 다른 점

핵심 차별점은 비밀 프롬프트가 아닙니다. 워크플로를 줄여준다는 점입니다.

• 생성과 편집을 위한 전용 스크립트 제공
• --ratio, --size 같은 명시적 플래그 지원
• 환경 변수 기반 API 설정
• scripts/batch_generate.py에서 배치 생성 지원
• references/prompts.md에 구체적인 스타일 패턴 예시 제공

그래서 범용 채팅 도구에 그때그때 임시 프롬프트를 손으로 다시 입력하는 방식보다 nanobanana usage가 훨씬 일관적입니다.

도입 전에 확인할 핵심 사항

도입 판단에 필요한 질문은 단순합니다.

• GEMINI_API_KEY가 필요합니다.
• Python 3.10+가 필요합니다.
• google-genai, pillow가 필요합니다.
• 로컬 스크립트를 실행하는 데 익숙해야 합니다.
• 이미지 품질은 프롬프트의 구체성에 크게 좌우된다는 점을 감안해야 합니다.

이건 설정 없는 웹 앱이 아니라, 실무형 스킬입니다.

nanobanana 스킬 사용 방법

nanobanana 설치 요구사항

nanobanana install을 시도하기 전에 아래를 먼저 확인하세요.

• Python 3.10+
• 유효한 GEMINI_API_KEY
• Google API에 접근 가능한 네트워크 환경
• Python 패키지 google-genai, pillow

의존성 설치:

pip install google-genai pillow

API 키 설정:

export GEMINI_API_KEY="your_api_key_here"

키 발급 주소: https://aistudio.google.com/apikey

skills 환경에 스킬 설치하기

skills 시스템을 사용 중이라면 아래 명령으로 스킬을 추가하세요.

npx skills add ReScienceLab/opc-skills --skill nanobanana

설치 후에는 다음 파일부터 읽는 것이 좋습니다.

• skills/nanobanana/SKILL.md
• skills/nanobanana/scripts/generate.py
• skills/nanobanana/references/prompts.md
• skills/nanobanana/scripts/batch_generate.py

이 순서로 보면 "내가 이걸 쓸 수 있나?"에서 "정확히 어떤 명령을 실행해야 하나?"까지 가장 빠르게 판단할 수 있습니다.

텍스트-투-이미지를 위한 기본 nanobanana 사용법

기본 명령은 프롬프트와 함께 generate 스크립트를 실행하는 것입니다.

python3 <skill_dir>/scripts/generate.py "a cute robot mascot, pixel art style" -o robot.png

텍스트만으로 시작할 때 쓰는 기본 흐름입니다. 출력 경로는 선택 사항이지만, 나중에 자동 생성된 파일명을 뒤지는 일을 줄이려면 직접 지정하는 편이 낫습니다.

nanobanana로 기존 이미지 편집하기

이미지 편집 시에는 프롬프트와 입력 이미지를 함께 넘기면 됩니다.

python3 <skill_dir>/scripts/generate.py "make the background blue" -i input.jpg -o output.png

기존 이미지를 유지하면서 특정 부분만 바꾸고 싶을 때 맞는 방식입니다. 프롬프트에는 장면 전체를 다시 설명하기보다, 바꾸려는 내용을 중심으로 적는 편이 좋습니다. 더 큰 폭의 변형을 원할 때만 전체 장면을 다시 서술하세요.

화면비와 출력 크기 선택하기

이 스킬은 다음과 같은 대표적인 화면비를 지원합니다.
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

예시:

python3 <skill_dir>/scripts/generate.py "cinematic landscape at sunrise" --ratio 21:9 -o landscape.png

더 높은 해상도가 필요하면:

python3 <skill_dir>/scripts/generate.py "professional product photo of headphones" --size 4K -o product.png

화면비는 워크플로 초반에 정하는 것이 좋습니다. 단순 크롭 문제가 아니라, 구도 자체가 달라지기 때문입니다.

프롬프트 탐색이 중요할 때는 배치 생성을 활용하기

scripts/batch_generate.py는 메인 스크립트 다음으로 설치 판단에 중요한 파일입니다. 하나의 프롬프트로 여러 결과를 생성할 수 있기 때문입니다.

예시:

python3 <skill_dir>/scripts/batch_generate.py "pixel art logo" -n 20 -d ./logos -p logo

병렬 생성도 지원합니다.

python3 <skill_dir>/scripts/batch_generate.py "landscape concept art" -n 20 --parallel 5

정답 하나를 맞히려는 상황보다, 스타일 방향을 탐색하는 작업에서 특히 유용합니다.

어떤 입력을 넣어야 nanobanana가 잘 작동하는가

"멋진 이미지 만들어줘" 같은 대략적인 요청은 대체로 너무 약합니다. 더 강한 입력에는 보통 다음 요소가 들어갑니다.

• 명확한 피사체
• 의도한 스타일
• 조명 또는 카메라 단서
• 구도 힌트
• 품질 또는 출력 목적

더 나은 프롬프트:

Professional product photo of wireless headphones on marble surface, soft studio lighting, 85mm lens, sharp focus, minimalist background

약한 프롬프트:

headphones advertisement

앞의 예시는 모델이 참고할 제어 신호를 더 많이 제공하므로, 결과가 지나치게 평범해질 가능성을 줄여줍니다.

거친 아이디어를 완성도 있는 프롬프트로 바꾸는 법

실무적으로 쓸 수 있는 nanobanana guide 방식은 다음과 같습니다.

1. 주제를 명시한다
2. 시각적 표현 방식을 지정한다
3. 장면 또는 구도 디테일을 더한다
4. 조명이나 분위기를 추가한다
5. 필요할 때만 품질 관련 단서를 넣는다

레포의 프롬프트 레퍼런스에서 가져온 템플릿:

Digital illustration of {subject}, {style} style, {colors} color palette, {mood} atmosphere

예시:

Digital illustration of an underwater research base, retro-futurist style, cyan and amber palette, mysterious atmosphere, detailed windows, glowing marine life

본격적으로 쓰기 전에 읽어둘 만한 저장소 파일

겉핥기 수준을 넘는 nanobanana usage를 원한다면 아래 파일을 확인하세요.

• SKILL.md: 선행 조건과 명령 패턴
• references/prompts.md: 프롬프트 구조와 카테고리별 예시
• scripts/generate.py: 지원 파일 형식, 유효한 화면비, 크기 옵션
• scripts/batch_generate.py: 동시 실행, 지연 처리, 파일명 지정 방식
• .claude-plugin/plugin.json: 패키징 맥락

레포 루트만 훑는 것보다 이 파일들을 직접 보는 편이 훨씬 유용합니다. 실제 스킬 로직이 소수의 파일에 집중되어 있기 때문입니다.

실무에서 알아야 할 제약과 트레이드오프

스크립트 기준으로 드러나는 중요한 한계는 다음과 같습니다.

• 입력 이미지 편집은 로컬 파일을 실제로 사용할 수 있어야 합니다.
• 지원하지 않는 이미지이거나 파일이 없으면 생성 전에 실패합니다.
• 화면비와 크기 옵션은 미리 정해진 유효값만 사용할 수 있습니다.
• 이 워크플로는 Google의 preview 이미지 모델에 의존하므로, 모델 업데이트에 따라 동작이 바뀔 수 있습니다.
• 배치 생성은 처리량을 높이지만, API 사용량과 rate limit 압박도 함께 커집니다.

고급 이미지 파이프라인 제어, 노드 기반 편집, 혹은 완전한 호스팅 UI가 필요하다면 이 스킬은 의도적으로 범위가 좁습니다.

nanobanana 스킬 FAQ

nanobanana는 초보자에게도 괜찮은가

그렇습니다. 기본적인 터미널 명령과 Python 패키지 설치에 익숙하다면 충분히 시작할 수 있습니다. nanobanana skill은 API 클라이언트를 처음부터 직접 만드는 것보다 단순하지만, 여전히 소비자용 앱보다는 개발자 지향 도구에 가깝습니다.

일반 채팅 프롬프트 대신 언제 nanobanana를 써야 하나

다음이 필요할 때는 nanobanana가 더 적합합니다.

• 저장되는 출력 파일
• 반복 가능한 명령 실행
• 로컬 파일 기반 이미지 편집
• 배치 생성
• 명시적인 화면비와 크기 선택

가벼운 실험 정도라면 일반 채팅 프롬프트로도 충분하지만, 출력 관리와 재현성이 중요해지는 순간 이 스킬 쪽이 더 낫습니다.

nanobanana는 생성과 편집을 모두 지원하나

네, 둘 다 지원합니다.

• 프롬프트 기반 텍스트-투-이미지 생성
• -i / --input을 사용한 이미지 편집
• 화면비 제어
• 2K, 4K 출력 설정
• 별도 스크립트를 통한 배치 생성

이 조합이야말로, 일회성 프롬프트를 직접 쓰는 대신 설치할 이유가 되는 핵심입니다.

nanobanana for Image Generation만으로 프로덕션 작업에 충분한가

컨셉 생성, 에셋 아이데이션, 프롬프트 탐색, 배치 생성 실험처럼 프로덕션 인접 워크플로에는 충분히 유용할 수 있습니다. 하지만 이것만으로 완전한 제품 파이프라인이 되지는 않습니다. 결과 검토, 선택, 저장, 필요하다면 후처리 단계는 여전히 직접 갖추어야 합니다.

어떤 경우에 nanobanana는 잘 맞지 않는가

다음이 필요하다면 nanobanana install은 건너뛰는 편이 낫습니다.

• 브라우저 중심의 노코드 경험
• 완전히 관리형인 GUI 워크플로
• 복잡한 다단계 편집 오케스트레이션
• 시간이 지나도 안정적인 모델 동작에 대한 강한 보장
• 외부 API 의존성 없는 이미지 생성

이 스킬은 얇고 실용적인 스크립팅 레이어로 가장 강점을 발휘합니다.

nanobanana 스킬 개선 방법

더 구체적인 프롬프트부터 시작하기

nanobanana 결과를 가장 빠르게 개선하는 방법은 프롬프트를 더 구체적으로 쓰는 것입니다. "cool", "beautiful" 같은 형용사에 기대기보다, 주제·스타일·구도·조명을 명확히 넣으세요.

약한 예:

a nice city

더 강한 예:

Aerial photograph of a dense coastal city at golden hour, dramatic shadows, high dynamic range, realistic urban detail, cinematic composition

원하는 출력 유형에 맞춰 프롬프트 스타일 맞추기

목표에 따라 프롬프트 언어를 달리 써야 합니다.

• pixel art: 제한된 팔레트, 선명한 픽셀, 레트로 게임 감성을 명시
• photorealistic: 렌즈, 조명, 초점, 재질의 사실감을 명시
• illustration: 화풍, 팔레트, 분위기, 브러시 또는 렌더링 느낌을 명시

이 정렬 방식은 references/prompts.md에서 가장 실용적인 아이디어 중 하나입니다.

이미지 편집은 바꾸려는 내용만 설명해 개선하기

편집 워크플로에서 많은 사용자가 프롬프트를 과하게 넣습니다. 이미 입력 이미지를 제공했다면, 먼저 바꾸려는 부분만 구체적으로 적어보세요.

Replace the gray wall with a warm blue studio backdrop while keeping the product position and lighting consistent

실제로 더 넓은 재해석을 원하는 경우가 아니라면, 이미지 전체를 처음부터 다시 쓰는 것보다 이 방식이 대체로 더 낫습니다.

배치 생성으로 탐색한 뒤 범위를 좁히기

실무적으로 좋은 nanobanana usage 반복 흐름은 다음과 같습니다.

1. 하나의 프롬프트 테마로 6~20개 변형을 생성한다
2. 가장 좋은 결과에서 무엇이 잘 먹혔는지 확인한다
3. 그 강점을 중심으로 프롬프트를 다시 쓴다
4. 더 좁은 스타일 설명이나 다른 화면비로 다시 실행한다

아무 결과도 보기 전에 추상적인 프롬프트 하나만 끝없이 다듬는 것보다 훨씬 효율적입니다.

자주 발생하는 실패 패턴

대표적인 품질 문제는 다음과 같습니다.

• 프롬프트가 지나치게 모호함
• 피사체에 맞지 않는 화면비 선택
• 서로 충돌하는 스타일을 과하게 한 프롬프트에 집어넣음
• 편집 프롬프트가 의도치 않게 장면 전체 재작성을 요구함
• 4K만 쓰면 약한 콘셉트가 해결될 거라고 가정함

좋지 않은 결과의 대부분은 마법 같은 키워드 부족이 아니라, 지시 품질 문제에서 나옵니다.

화면비를 사후 옵션이 아니라 창작 제어 수단으로 쓰기

더 나은 nanobanana for Image Generation 결과를 원한다면:

• 1:1: 아이콘, 아바타, 제품 크롭
• 9:16: 세로형 모바일 중심 장면
• 16:9 또는 21:9: 시네마틱 풍경
• 4:5: 포스터형 구도

화면비를 잘못 고르면 프레이밍이 답답해지거나 공간이 낭비되는 일이 많습니다.

스크립트를 직접 테스트해 신뢰도 높이기

스킬 설명이 모호하게 느껴진다면, 판단하기 전에 직접 스크립트를 실행해 보세요. scripts/generate.py와 scripts/batch_generate.py는 길지 않아서 옵션 지원 범위, 실패 경로, 파일명 처리 방식을 직접 확인하기 좋습니다. 이 레포에서는 상위 설명만 읽는 것보다 스크립트를 직접 보는 편이 신뢰를 더 빨리 높여줍니다.

첫 결과가 아깝게 빗나갔을 때 가장 좋은 다음 개선법

처음부터 전부 다시 시작하지 마세요. 한 번에 변수 하나씩만 바꾸는 편이 낫습니다.

• 주제 디테일
• 스타일 문구
• 조명 단서
• 화면비
• 편집 지시 범위

이렇게 해야 모델이 무엇에 반응하는지 빠르게 학습할 수 있고, 앞으로의 nanobanana guide 감각도 더 빨리 좋아집니다.