제미나이 이미지 생성 방법: 앱에서 API까지 모델·한도·코드
Gemini 앱은 무료 계정에 Nano Banana 2, 유료 요금제에 2.1을 쓰고 장수는 비공개입니다. 무료 장수를 밝힌 곳은 AI 모드(24시간 25장)뿐이며 API는 첫 장부터 유료입니다.
목차

제미나이(Gemini)로 그림 한 장을 가장 빨리 만드는 방법은 컴퓨터에서 gemini.google.com에 들어가 왼쪽 위 사이드바 열기 → 이미지를 누르고, 원하는 장면을 문장으로 적는 것입니다. 요금제가 없는 무료 계정은 Nano Banana 2(나노바나나 2)로 이미지를 만들고 1K 해상도로 내려받습니다. Google AI Plus·Pro·Ultra 구독자는 2026년 10월 6일 나온 Nano Banana 2.1을 씁니다. 만 13세 이상이면 생성, 만 18세 이상이면 편집까지 할 수 있습니다. 다만 무료로 몇 장까지 되는지는 Google이 공개하지 않습니다.
2026년 10월 8일 기준으로 달라진 점은 모델 쪽에 몰려 있습니다. Google은 Nano Banana 2.1(gemini-nano-banana-2.1)을 Gemini API에 정식 출시했고, 1K·2K 장당 요금은 Nano Banana 2의 절반 수준입니다. Nano Banana 2(gemini-3.1-flash-image)는 API에서 지원 중단 모델이 됐지만 종료일은 발표되지 않았습니다. 초대 Nano Banana(gemini-2.5-flash-image)는 Google 페이지마다 종료일이 달라 2026년 10월 2일과 2027년 3월 15일이 함께 보입니다. 바뀌지 않은 것도 있습니다. Imagen은 이미 Gemini API에서 종료됐고, 무료 장수를 숫자로 밝힌 곳은 Google 검색 AI 모드(24시간 최대 25장) 하나뿐이며, Gemini API는 첫 장부터 요금이 붙습니다. 개발자라면 새 프로젝트는 Interactions API와 Nano Banana 2.1로 시작하는 것이 Google의 현재 권장 방식입니다.
어디서 만들지 먼저 고르기
Google에서 이미지를 만들 수 있는 곳은 다섯 군데이고, 같은 "Nano Banana"라도 입구마다 실제로 돌아가는 모델과 한도가 다릅니다. 아래 표는 2026년 10월 8일 기준 Google 도움말, 제품 페이지, API 문서를 정리한 것입니다.
| 입구 | 실제로 쓰이는 모델 | 무료 계정 | 유료 요금제·요금 | 조건 |
|---|---|---|---|---|
| Gemini 앱 | 무료 계정은 Nano Banana 2(Flash-Lite 선택 시 2 Lite). Google AI 요금제는 Nano Banana 2.1, Nano Banana Pro로 다시 실행 가능 | 생성 가능. 장수 비공개(5시간·주간 연산량 한도), 1K 다운로드 | 한도가 Plus 2배, Pro 4배, Ultra는 Pro의 5배 또는 20배. 2K 다운로드 | 생성 만 13세, 편집 만 18세 이상 |
| Google 검색 AI 모드 | 기본 모델명은 공개되지 않음. Nano Banana Pro는 한국에서는 AI Pro·Ultra 구독자 대상 | 24시간 최대 25장 | Plus 50장, Pro 100장, Ultra 1,000장(24시간 기준) | 만 18세 이상, 한국·한국어 지원 |
| Google Flow | 무료로 쓰는 이미지 모델은 Nano Banana 2 Lite | 매일 50크레딧 | Plus 월 200, Pro 월 1,000, Ultra 월 10,000 또는 25,000크레딧 추가 | 만 18세 이상, 한국 지원 |
| Google AI Studio | Nano Banana 등 프리미엄 모델은 AI Pro 혜택으로 분류 | 적은 할당량, 이미지 장수 비공개 | AI Pro·Ultra에서 할당량 증가 | 구독 혜택은 AI Studio 웹 화면에만 적용 |
| Gemini API | Nano Banana 2.1, 2 Lite, Pro. Nano Banana 2는 지원 중단(종료일 미발표) | 무료 이미지 없음 | 장당 $0.0336~$0.24, Batch는 절반 | 결제를 연결한 프로젝트 필요 |
표를 작업에 대입하면 이렇게 나뉩니다.

- 한두 장을 지금 바로 만들고 싶다: Gemini 앱. 로그인만 하면 되고 편집도 대화로 이어집니다.
- 무료로 몇 장까지 되는지 확실히 알아야 한다: AI 모드. google.com/ai에서 추가(+) → 이미지 만들기를 누르면 되고, 24시간에 최대 25장이라는 숫자가 도움말에 적혀 있습니다. 다만 만 18세 이상만 쓸 수 있고, 한도는 수요와 용량에 따라 바뀔 수 있다고 명시돼 있습니다.
- 영상 작업과 함께 장면 이미지를 만든다: Google Flow. 크레딧은 첫 생성을 할 때 그날 분량이 채워지고, 쓰지 않은 크레딧은 다음 날로 넘어가지 않습니다. 모델과 크레딧 소모량은 프롬프트 입력창의 설정에서 확인할 수 있습니다. Flow 도움말은 기본 모델을 페이지마다 다르게 적고 있어서, 무료로 Nano Banana Pro를 쓸 수 있다고 기대하기보다 설정 화면에 표시되는 모델을 기준으로 삼는 편이 안전합니다.
- 서비스에 붙이거나 대량·4K 이미지가 필요하다: Gemini API. 아래 API 절에서 코드와 함께 설명합니다.
AI Studio는 API 키를 만들고 프롬프트를 시험하는 곳으로 보는 것이 맞습니다. Google은 AI Studio 요금제 표에서 무료 계정을 "적은 할당량"으로, Nano Banana를 AI Pro에서 열리는 프리미엄 모델로 분류하고 있어서, 무료 계정으로 AI Studio에서 이미지를 넉넉히 만들 수 있다고 기대하기는 어렵습니다. 또 Google AI Pro 구독을 해도 그 혜택은 AI Studio 웹 화면에만 적용되고, API 호출은 따로 과금됩니다.
무료로 쓸 수 있는 공식 경로만 따로 비교하고 싶다면 Nano Banana 무료로 쓸 수 있을까? 공식 경로 3곳과 한도에서 경로별 한도를 비교합니다.
Gemini 앱에서 첫 이미지 만들기
아래 순서는 Google 도움말의 컴퓨터 기준 안내이고, 굵게 표시한 버튼 이름은 한국어 도움말 표기입니다. Android와 iPhone·iPad 앱은 도움말에 별도 안내가 있고 메뉴 위치가 다를 수 있습니다.
새 이미지 만들기
- 컴퓨터에서 gemini.google.com에 로그인합니다.
- 왼쪽 위에서 사이드바 열기를 누르고 이미지를 클릭합니다.
- 템플릿을 고르거나 프롬프트를 입력합니다. 무료 계정이면 Nano Banana 2, Google AI 요금제가 있으면 Nano Banana 2.1이 이미지를 만듭니다.
Google의 Gemini 이미지 생성 소개 페이지는 입력창 도구 메뉴에서 바나나(🍌) 아이콘이 붙은 이미지 생성 항목을 고르는 방법도 안내합니다.
무료 계정에서 다른 Nano Banana 모델을 쓰려면 이미지를 요청하기 전에 Gemini 모델을 바꿉니다. 2026년 9월 26일 기준 도움말에 따르면 모델 선택이 Flash-Lite이면 Nano Banana 2 Lite, Flash나 Pro이면 Nano Banana 2가 쓰입니다. Nano Banana 2 Lite는 속도에 맞춘 모델이라 빠른 시안에는 좋지만, 참조 이미지를 여러 장 넣거나 여러 번 고치는 작업에는 맞지 않습니다. Google은 요금제 사용자가 쓰는 Nano Banana 2.1을 "가장 뛰어난 이미지 생성·편집 모델"로 소개하며, 글자 표현과 인포그래픽·다이어그램의 정확도가 나아졌다고 설명합니다.
프롬프트는 "피사체 + 동작 + 장면"에 스타일을 더하면 됩니다. Google 도움말은 "그려 줘", "만들어 줘" 같은 요청으로 시작하고, 사진처럼 사실적인 스타일·수채화·만화 일러스트처럼 원하는 화풍을 밝히라고 권합니다. 화면비가 중요하면 "2:3 비율"처럼 문장에 적어도 됩니다.
비 오는 저녁 서울 골목의 작은 카페 앞을 우산을 쓴 고양이가 지나가는 장면을 그려 줘. 따뜻한 창문 불빛, 수채화 스타일, 가로로 긴 구도.
수업이나 업무 자료라면 누가 볼지와 용도를 함께 적는 편이 결과가 좋습니다. "초등학교 4학년 과학 수업용으로, 광합성을 요리 레시피처럼 설명하는 인포그래픽. 재료는 햇빛·물·이산화탄소, 완성 요리는 포도당"처럼 대상과 목적을 넣는 식입니다. 이미지 안에 글자가 많이 들어가야 한다면 Google API 문서의 조언대로 들어갈 문구를 먼저 만들게 한 뒤, 그 문구로 이미지를 요청하는 두 단계가 더 안정적입니다.
그 밖에 Google이 권하는 요령은 다음과 같습니다.
- "차 없이"보다 "텅 빈 거리"처럼 원하지 않는 요소를 빼는 대신 원하는 상태를 묘사합니다.
- 광각, 접사, 로우 앵글 같은 카메라 용어로 구도를 지정합니다.
- 결과가 마음에 들지 않으면 처음부터 다시 쓰지 말고 "나머지는 그대로 두고 하늘만 더 어둡게"처럼 대화로 이어서 고칩니다.
Google의 API 문서는 한국어(ko-KR)를 이미지 생성 성능이 가장 좋은 프롬프트 언어 목록에 넣고 있어서, 한국어로 써도 괜찮습니다. 용도별 템플릿은 Nano Banana 프롬프트 작성법: 실전 가이드와 검증용 템플릿 50개에서 볼 수 있습니다.
만든 이미지나 내 사진 편집하기
편집은 만 18세 이상 개인 계정에서만 됩니다.
- gemini.google.com에서 왼쪽 위 사이드바 열기 → 라이브러리를 클릭합니다.
- 수정할 이미지를 찾아 클릭한 뒤, 이미지 아래의 채팅을 누릅니다.
- 하단 입력창에 바꿀 내용을 적고 제출을 누릅니다.
기기에 있는 사진을 올려서 고치게 할 수도 있고, 여러 장을 올려 합친 새 이미지를 요청할 수도 있습니다. 한 번에 올릴 수 있는 파일은 최대 10개입니다. 얼굴과 목소리를 등록해 두면 매번 사진을 올리지 않아도 본인이 등장하는 이미지를 만드는 아바타 기능도 있습니다.
Pro로 다시 실행하고 내려받기
유료 요금제 구독자는 만든 이미지 오른쪽 아래의 더보기 → Pro로 다시 실행으로 Nano Banana Pro 결과를 받을 수 있습니다. Google은 특히 글자가 들어간 이미지와 인포그래픽에서 Pro가 더 세밀하다고 설명합니다. 단, 그날 이미지 할당량을 다 쓰면 Pro로 다시 실행도 더 이상 되지 않습니다.
내려받을 때는 이미지 위에 마우스를 올리고 원본 크기 다운로드를 누릅니다. Google 도움말 기준으로 요금제가 없으면 1K, Google AI 요금제가 있으면 2K 해상도로 저장됩니다. Gemini 이미지 생성 소개 페이지는 Nano Banana 2와 2.1을 모두 "2K 해상도"로 소개하지만, 다운로드 해상도를 요금제별로 나눠 적은 곳은 도움말입니다. 무료 계정에서 2K가 필요하다면 실제로 받은 파일의 크기를 확인하세요. 이미지 아래 더보기에서 Google Docs로 내보낼 수도 있습니다.
무료 한도와 이미지가 안 만들어질 때
Gemini 앱의 한도는 "하루 몇 장"이 아니라 연산량 기준입니다. Google 도움말에 따르면 프롬프트의 복잡도, 사용한 모델과 기능, 대화 길이를 합쳐 계산하고, 주간 한도에 닿을 때까지 5시간마다 초기화됩니다. 요금제가 없으면 "표준 한도", Google AI Plus는 그 2배, AI Pro는 4배, AI Ultra는 AI Pro의 5배 또는 20배입니다. 이미지 장수는 어느 요금제에도 적혀 있지 않고, Nano Banana 2.1 출시 뒤의 제품 페이지도 "유료 요금제는 생성 한도가 더 높다"고만 적고 있습니다.
내 사용량은 gemini.google.com/usage에서 볼 수 있습니다. 현재 5시간 구간과 주간 한도의 사용 비율(%)과 초기화 시각이 표시되지만 장수는 나오지 않습니다. 요금제 없는 계정 하나로 대만에서 측정한 사례(2026년 9월 23일)에서는 간단한 이미지 1장이 현재 구간 사용량을 약 2~3% 올렸고 주간 한도는 0% 그대로였습니다. 표본이 한두 장뿐이고 프롬프트에 따라 소모량이 달라지므로, 이 비율로 몇 장이 가능한지 계산할 수는 없습니다.
"무료 하루 100장"이라는 숫자는 Google이 2025년에 밝힌 과거 수치입니다. 2026년 3월까지 도움말에 있던 요금제별 장수 표도 지금은 삭제됐고, 현재 도움말에는 장수가 없습니다.
한도에 닿았을 때 할 수 있는 일은 세 가지입니다.
- 5시간 구간 한도라면 표시된 초기화 시각까지 기다립니다.
- 주간 한도라면 초기화 날짜까지 기다리거나 요금제를 올립니다. 미국 기준 가격은 Google AI Plus 월 $4.99, AI Pro 월 $19.99, AI Ultra 월 $99.99 또는 $199.99이고, 한국 원화 가격은 한국 구독 페이지에서 확인해야 합니다. 요금제를 올리면 한도와 함께 사용 모델도 Nano Banana 2.1로 바뀝니다.
- 당장 몇 장이 더 필요하다면 AI 모드(24시간 최대 25장)나 Flow(매일 50크레딧)로 옮깁니다. 서로 다른 제품이라 한도도 따로입니다.
한도가 아닌데 이미지가 안 나온다면 다음을 확인합니다.
- 나이와 계정: 개인 계정 기준 생성은 만 13세, 편집은 만 18세 이상입니다. 학교 계정은 접근 제한이 다를 수 있습니다.
- 정책 위반 감지: Google 서비스 약관이나 금지된 사용 정책 위반 가능성이 감지되면 Gemini 앱이 이미지를 삭제할 수 있습니다.
- 모델 선택: Flash-Lite 상태에서는 Nano Banana 2 Lite가 쓰이므로 참조 이미지를 여러 장 쓰는 요청이나 연속 편집이 잘 안 될 수 있습니다. Flash나 Pro로 바꿔 다시 요청합니다.
- 파일 업로드 한도: 파일을 올려 편집하는 경우 일정 시간 동안의 업로드 한도가 따로 있고, 시간이 지나면 초기화됩니다.
증상별 해결 순서는 Gemini에서 Nano Banana가 안 될 때: 이미지 오류 12가지 해결 분기에서 더 자세히 다룹니다.
고화질로 받기와 워터마크
Gemini 앱에서 받을 수 있는 최대 해상도는 요금제가 없으면 1K, 요금제가 있으면 2K입니다. 4K가 필요하면 Gemini API에서 Nano Banana 2.1, Nano Banana 2, Nano Banana Pro 중 하나에 image_size를 4K로 지정해야 합니다. Nano Banana Pro와 2.1에서 16:9 비율 4K는 5504×3072, Nano Banana Pro의 1:1 4K는 4096×4096 크기로 나옵니다. 업스케일링과 실제 해상도 확인은 제미나이 이미지 고화질 프롬프트: 업스케일링·4K 설정·실제 해상도 확인법을 참고하세요.
워터마크는 두 종류입니다. 눈에 보이지 않는 SynthID 워터마크는 앱이든 API든 Google이 만든 모든 이미지에 들어가고, Gemini 앱 이미지에는 C2PA 정보도 함께 남습니다. 이 둘은 설정으로 끌 수 없습니다. 눈에 보이는 워터마크는 Gemini 앱 설정의 미디어 워터마크에서 끌 수 있는데, 2026년 8월 말 기준 Google 도움말에 따르면 한국에서는 이 설정이 AI Ultra 구독에서만 나타납니다. 직장·학교 계정은 보이는 워터마크를 끌 수 없습니다. 자세한 적용 범위는 Gemini 워터마크 끄기: 미디어 워터마크 설정과 적용 범위에 정리돼 있습니다.
Gemini API로 만들기
API로 이미지를 만들 때 먼저 알아야 할 점은 이미지 모델에 무료 등급이 없다는 것입니다. 2026년 10월 8일 기준 Gemini API 요금 페이지는 Nano Banana 2.1을 포함한 모든 이미지 모델의 무료 등급을 "제공되지 않음"으로 표시하고 있어서, 결제를 연결한 프로젝트의 API 키가 있어야 첫 장이 만들어집니다.
Nano Banana 모델별 상태와 장당 요금
| 모델 | 모델 ID | 상태 | 해상도와 장당 요금 | 화면비 | 참조 이미지 | Google 검색 그라운딩 |
|---|---|---|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | 정식(2026년 10월 6일) | 1K $0.0336, 2K $0.0504, 4K $0.113 | 14가지 | 사물 10장 + 인물 4장 | 웹 검색·이미지 검색 |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | 정식 | 1K만, $0.0336 | 10가지 | 사물 14장 | 사용 불가 |
| Nano Banana Pro | gemini-3-pro-image | 정식 | 1K·2K $0.134, 4K $0.24 | 10가지 | 사물 6장 + 인물 5장 | 웹 검색 |
| Nano Banana 2 | gemini-3.1-flash-image | 지원 중단, 종료일 미발표 | 0.5K $0.045, 1K $0.067, 2K $0.101, 4K $0.151 | 14가지 | 사물 10장 + 인물 4장 | 웹 검색·이미지 검색 |
| Nano Banana | gemini-2.5-flash-image | 지원 중단, 종료일 표기 충돌 | 1K급, $0.039 | - | - | - |
새 프로젝트라면 Nano Banana 2.1로 시작하는 것이 Google의 현재 권장입니다. Google은 2.1을 Nano Banana 2의 업데이트로 소개하면서 화질, 프롬프트 준수, 여러 번 편집할 때의 인물 일관성, 글자 표현이 나아졌다고 밝혔고, 1K·2K 장당 요금은 Nano Banana 2의 절반 수준입니다. 작업별로 나누면 다음과 같습니다.
- 대부분의 작업: Nano Banana 2.1. 1K·2K·4K를 모두 지원하고 참조 이미지와 검색 그라운딩도 Nano Banana 2와 같은 수준입니다.
- 1K 이미지를 싸고 빠르게 많이 뽑을 때: Nano Banana 2 Lite도 후보입니다. 1K 장당 요금은 2.1과 같은 $0.0336이지만, 100만 토큰당 입력 $0.25, 사고 토큰 $1.50으로 2.1(입력 $1.50, 텍스트·사고 $7.50)보다 토큰 단가가 낮습니다. 대신 2K 이상, 연속 편집, 검색 그라운딩은 안 됩니다.
- 글자가 정확해야 하는 작업: Nano Banana Pro. 2026년 10월 8일 같은 프롬프트 9건을 1K로 한 번씩 생성한 비교에서 Pro는 요청한 문구를 그대로 지켰고, 2.1은 글자 작업 3건에서 문구를 바꿨습니다. 결과는 나노바나나 2.1 vs 프로 vs GPT Image 2.5 차이: 같은 프롬프트 9건 실측에서 볼 수 있습니다.
- 512px 미리보기나 이미 돌아가는 연동: Nano Banana 2. 0.5K는 Nano Banana 2에만 있습니다. Gemini API에서는 지원 중단 모델이 됐지만 종료일이 발표되지 않았으므로 당장 멈추지는 않습니다. 다만 Google은 2.1로 옮기라고 안내하고 있어 새로 시작할 이유는 없습니다. Google Cloud의 Vertex AI는 수명 주기를 따로 관리하며, Nano Banana 2 지원 종료를 "2027년 5월 28일 이후"로 적고 있습니다.
- 초대 Nano Banana: Gemini API 지원 중단 페이지는 종료일을 2027년 3월 15일로, 같은 API의 요금 페이지는 2026년 10월 2일로 적고 있습니다. 어느 날짜가 맞든 Google은 Nano Banana 2 Lite로 옮기라고 권하므로, 아직 이 모델을 쓰는 코드가 있다면 날짜와 상관없이 모델 ID를 바꿔 두세요.
2.1 출시 내용과 앱에서의 차이는 나노바나나 2.1 출시: 가격·사용법, 1K·2K 단가는 나노바나나 2의 절반에, Lite·2·2.1·Pro의 작업별 비교는 Nano Banana 2 Lite·2·2.1·Pro 차이: 작업별 선택법에 있습니다.
화면비는 Nano Banana Pro와 2 Lite가 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9의 10가지이고, Nano Banana 2.1과 2는 여기에 1:4, 4:1, 1:8, 8:1이 더해집니다. 참조 이미지는 모델과 관계없이 합계 14장까지입니다.
비용은 "장수 × 장당 요금"으로 계산합니다. Nano Banana 2.1로 2K 이미지 1,000장을 만들면 1,000 × $0.0504 = $50.4이고, 결과를 최대 24시간 기다려도 되는 작업을 Batch API로 돌리면 절반인 1,000 × $0.0252 = $25.2입니다. 같은 작업을 Nano Banana 2로 하면 1,000 × $0.101 = $101입니다. Nano Banana Pro 4K 100장은 100 × $0.24 = $24입니다. 장당 요금 외에 입력 토큰과 사고 토큰이 따로 더해지고, 모델이 중간 사고 과정에서 만드는 이미지(최대 두 장)는 요금에 포함되지 않습니다. 해상도별 비용은 나노바나나 2(Nano Banana 2) API 가격: 장당 $0.045~$0.151, 2.1은 1K 절반에서 더 자세히 계산합니다.
준비: API 키와 SDK
- Google AI Studio의 API 키 페이지에서 키를 만들고, 그 프로젝트에 결제를 연결합니다.
- 터미널에서 키를 환경 변수로 등록하고 Python SDK를 설치합니다.
export GEMINI_API_KEY="YOUR_API_KEY"
pip install -U google-genaiJavaScript를 쓴다면 npm install @google/genai로 설치합니다. 속도 한도는 API 키가 아니라 프로젝트 단위로 적용되고, 하루 요청 수는 미국 태평양 시간 자정(한국 시간 오후 4시, 미국 서머타임이 끝나면 오후 5시)에 초기화됩니다. 결제만 연결하면 Tier 1, 누적 결제 $100에 3일이 지나면 Tier 2, $1,000에 30일이 지나면 Tier 3로 올라가며, 실제 수치는 AI Studio에서 확인할 수 있습니다.
화면비와 해상도를 지정해 생성하기
Google은 2026년 6월 Interactions API를 정식 출시하고 새 프로젝트에 권장합니다. 기존 generateContent는 레거시로 분류됐지만 계속 지원되며, 앞으로 나오는 새 모델과 기능은 Interactions API로 제공됩니다. 아래 코드는 Google 이미지 생성 문서의 Python 예제 형식을 그대로 따르고, 모델 ID만 Nano Banana 2.1로 바꿨습니다.

import base64
from google import genai
client = genai.Client() # 환경 변수 GEMINI_API_KEY를 읽습니다
interaction = client.interactions.create(
model="gemini-nano-banana-2.1",
input="비 오는 저녁 서울 골목의 작은 카페, 따뜻한 창문 불빛, 수채화 스타일",
response_format={
"type": "image",
"mime_type": "image/jpeg",
"aspect_ratio": "16:9",
"image_size": "2K", # 반드시 대문자 K
},
)
with open("cafe.jpg", "wb") as f:
f.write(base64.b64decode(interaction.output_image.data))response_format을 생략하면 기본값은 1K 해상도이고, 입력 이미지가 있으면 그 크기에 맞추며 없으면 1:1로 나옵니다. 응답은 기본적으로 텍스트와 이미지가 함께 오지만, 위처럼 type을 image로 지정하면 이미지만 돌아옵니다. interaction.output_image는 응답에서 마지막으로 생성된 이미지를 가리킵니다.
참조 이미지로 편집하고 이어서 고치기
기존 이미지를 고치려면 input에 텍스트와 이미지를 목록으로 함께 넣습니다. 이미지는 base64로 인코딩해 보냅니다.
with open("product.png", "rb") as f:
image_b64 = base64.b64encode(f.read()).decode("utf-8")
edit = client.interactions.create(
model="gemini-nano-banana-2.1",
input=[
{"type": "text", "text": "배경만 흰색 스튜디오로 바꾸고 제품은 그대로 두세요."},
{"type": "image", "data": image_b64, "mime_type": "image/png"},
],
)
with open("product_white.png", "wb") as f:
f.write(base64.b64decode(edit.output_image.data))결과를 조금씩 다듬을 때 Google이 권하는 방법은 앞 호출의 ID를 previous_interaction_id로 넘겨 대화를 이어 가는 것입니다. 이미지를 다시 올리지 않아도 앞 결과를 기준으로 수정합니다.
edit_2 = client.interactions.create(
model="gemini-nano-banana-2.1",
input="조명만 조금 더 따뜻하게 바꾸고 다른 요소는 바꾸지 마세요.",
previous_interaction_id=edit.id,
)
with open("product_warm.png", "wb") as f:
f.write(base64.b64decode(edit_2.output_image.data))이 방식은 Interactions API가 요청을 저장하기 때문에 가능합니다. 저장 기간은 무료 등급 1일, 유료 등급 55일이고, store=False로 저장을 끄면 previous_interaction_id도 쓸 수 없습니다. 연속 편집에는 Nano Banana 2 Lite가 맞지 않으므로 Nano Banana 2.1이나 Pro를 쓰세요.
코드가 실패하거나 결과가 어긋나는 조건
- 소문자 해상도:
image_size에1k,2k처럼 소문자를 쓰면 요청이 거부됩니다. - 2.1에 0.5K 요청: Nano Banana 2.1은 1K·2K·4K만 지원합니다. 0.5K(512px)는 Nano Banana 2에서만 됩니다.
- Lite에 고해상도 요청: Nano Banana 2 Lite는 1K만 지원합니다. 2K나 4K가 필요하면 모델을 바꿔야 합니다.
- Lite에 검색 도구 사용: Google 검색 그라운딩은 Nano Banana 2 Lite에서 쓸 수 없습니다. 이미지 검색 그라운딩은 Nano Banana 2.1과 2에서만 되며, 웹에서 찾은 실제 인물 사진은 쓰지 않습니다.
- 장수 지정: 몇 장을 만들라고 요청해도 모델이 정확히 그 수를 지키지 않을 수 있습니다.
- Nano Banana 2 코드를 2.1로 옮길 때: 모델 ID만 바꾸면 사고 수준 기본값이
minimal에서medium으로 바뀝니다. 사고 토큰도 요금에 들어가므로, 비용과 응답 시간을 이전과 맞추려면thinking_level을 직접 지정하세요. Vertex AI에서는 2.1에seed,temperature,topP,topK,logprobs를 넣으면 API 오류가 납니다. - 예전 코드: Imagen을 부르던 코드는 Imagen이 종료돼 더 이상 동작하지 않습니다. Imagen 4 계열은 2026년 8월 17일 Gemini API에서 종료됐고, Google이 지정한 대체 모델은 Nano Banana 2.1입니다.
gemini-2.5-flash-image는 종료일 표기가 페이지마다 다르므로 지금 바로 바꿔 두는 편이 안전합니다. 현재 모델 ID에는-preview가 붙지 않습니다. - 무료 키로 호출: 결제를 연결하지 않은 프로젝트에서는 이미지 모델을 쓸 수 없습니다.
생각(thinking) 기능은 이미지 모델에서 항상 켜져 있고 끌 수 없습니다. Nano Banana 2와 2 Lite는 thinking_level을 minimal(기본값)과 high 중에서, Nano Banana 2.1은 minimal, medium(기본값), high 중에서 고릅니다. Nano Banana 2.1, 2, 2 Lite는 공개 YouTube URL이나 Files API로 올린 동영상을 입력으로 받을 수도 있습니다.
장당 요금을 고정하고 싶을 때
Google API는 해상도와 사고 토큰에 따라 요금이 달라집니다. 2K·4K 이미지를 많이 만들면서 해상도와 관계없이 단가를 고정하고 싶다면, 제3자 유료 서비스인 laozhang.ai가 선택지가 될 수 있습니다. Google이 운영하는 서비스가 아니며, 무료 한도가 아니라 호출할 때마다 요금이 나가는 방식입니다.
안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.
2026년 10월 8일 기준 공개 가격은 출력 크기, thinking 수준, 참조 이미지 수, 생성·편집 여부와 관계없이 호출당 고정입니다. 모델 전체는 laozhang.ai Nano Banana 이미지 API 문서에, 2.1 호출 예제는 laozhang.ai Nano Banana 2.1 API 문서에 있습니다.
| 모델 ID | laozhang.ai(호출당) | Google API(장당, 토큰 별도) |
|---|---|---|
gemini-nano-banana-2.1 | $0.045 | 1K $0.0336, 2K $0.0504, 4K $0.113 |
gemini-3.1-flash-lite-image | $0.025 | 1K $0.0336 |
gemini-3.1-flash-image | $0.055 | 0.5K $0.045, 1K $0.067, 2K $0.101, 4K $0.151 |
gemini-3-pro-image | $0.09 | 1K·2K $0.134, 4K $0.24 |
gemini-2.5-flash-image | $0.02 | $0.039, 종료일 표기 충돌 |
Nano Banana 2.1은 해상도에 따라 유리한 쪽이 갈립니다. Google 쪽에는 장당 요금에 사고 토큰이 더해지는데, 2026년 10월 8일 laozhang.ai로 2.1을 호출한 테스트에서 보고된 사고 토큰은 호출당 510~1,107개였습니다. 이를 100만 토큰당 $7.50로 계산하면 약 $0.004~$0.008입니다. 그러면 Google 기준 1K는 약 $0.037~$0.042로 laozhang.ai($0.045)보다 조금 싸고, 2K는 약 $0.054~$0.059, 4K는 약 $0.117~$0.121로 laozhang.ai 쪽이 쌉니다. 같은 테스트에서 2.1 호출은 매번 $0.045가 청구됐고, 512를 보내면 오류 없이 1K 이미지가 나오면서 요금이 그대로 붙었으니 0.5K는 보내지 마세요. Nano Banana 2는 laozhang.ai에서 같은 가격으로 계속 제공되며, Nano Banana Pro는 모든 해상도에서 laozhang.ai 쪽이 쌉니다.
사용할 때 알아 둘 점이 두 가지 있습니다. OpenAI 호환 엔드포인트(/v1/chat/completions)에서는 화면비와 해상도를 지정할 수 없고 1:1 1K로 나오므로, 2K·4K를 받으려면 Gemini 형식 엔드포인트(/v1beta/models/{model}:generateContent)를 써야 합니다. 그리고 이 엔드포인트는 앞에서 설명한 Interactions API가 아니라 generateContent 형식입니다. 코드 없이 브라우저에서 쓰고 싶다면 같은 API 키로 쓰는 YingTu가 있습니다.
자주 묻는 질문
제미나이로 무료로 이미지를 만들 수 있나요?
네. Gemini 앱, Google 검색 AI 모드, Google Flow는 요금제가 없어도 이미지를 만들 수 있습니다. Gemini 앱의 무료 계정은 Nano Banana 2로 만들고 1K로 내려받으며, Nano Banana 2.1은 Google AI 요금제가 있어야 쓸 수 있습니다. 반면 Gemini API는 Nano Banana 2.1을 포함해 무료 이미지 등급이 없어서 첫 장부터 요금이 나갑니다.
제미나이 무료 버전은 하루에 몇 장까지 만들 수 있나요?
Gemini 앱은 장수를 공개하지 않습니다. 연산량 기준 한도가 5시간마다 초기화되고, 그 위에 주간 한도가 있습니다. 2026년 10월 기준으로 장수를 명시한 무료 입구는 AI 모드뿐이며 24시간에 최대 25장입니다. 인터넷에 도는 "하루 100장"은 2025년에 발표됐던 과거 수치입니다.
제미나이에서 이미지가 생성되지 않는 이유는 무엇인가요?
주된 원인은 5시간·주간 한도 도달, 나이 조건(생성 만 13세, 편집 만 18세), 학교·직장 계정 제한, 정책 위반 감지로 인한 삭제, Flash-Lite 모델에서의 여러 장 참조나 연속 편집입니다. 먼저 gemini.google.com/usage에서 한도를 확인하고, 한도가 남아 있다면 모델을 Flash나 Pro로 바꿔 다시 요청해 보세요.
Nano Banana 2.1과 Nano Banana 2 중 무엇을 써야 하나요?
Gemini 앱에서는 고를 필요가 없습니다. 무료 계정은 Nano Banana 2, Google AI Plus·Pro·Ultra 구독자는 Nano Banana 2.1이 쓰입니다. Gemini API에서는 새 프로젝트라면 gemini-nano-banana-2.1을 쓰세요. 1K·2K 장당 요금이 Nano Banana 2의 절반 수준이고, Google이 옮겨 가라고 안내하는 모델입니다. Nano Banana 2는 지원 중단됐지만 2026년 10월 8일 기준 종료일이 발표되지 않아, 512px 출력이 꼭 필요할 때만 남겨 둘 만합니다.
예전 Imagen 코드나 generateContent 코드는 아직 쓸 수 있나요?
Imagen은 Gemini API에서 종료돼 쓸 수 없습니다. generateContent는 레거시로 분류됐지만 계속 지원되므로 기존 코드를 당장 버릴 필요는 없습니다. 다만 gemini-2.5-flash-image는 Google 페이지에 따라 종료일이 2026년 10월 2일과 2027년 3월 15일로 다르게 적혀 있으니 gemini-nano-banana-2.1 같은 현재 모델 ID로 맞춰 두세요. 새 프로젝트라면 Google이 권하는 Interactions API로 시작하는 편이 이후 새 기능을 쓰기에 유리합니다.





