Nano Banana 2.1 지원 범위
공개 가격은 2026년 10월 7일 기준이며 2026년 10월 14일에 확인했습니다. 최신 가격은 모델 및 가격에서 볼 수 있습니다. 2026년 10월 7일과 14일에 1K, 2K, 4K로 직접 호출해 본 결과 모두 $0.045로 기록되었습니다. 이 모델은 Google 공식 채널에서 제공되고 건당 과금 경로는 가격이 하나이므로, 2K와 4K 이미지는 Google 표준 가격(2K $0.0504, 4K $0.113)보다 저렴합니다. 자세한 내용은 Nano Banana 개요의 공식 가격 비교를 참고하세요.

아래 생성 예제의 출력: 2K, 16:9. 프롬프트: Generate an image of a corner cafe after rain at dusk, warm light on the wet pavement, with a neon sign that reads "BANANA CAFE".
파라미터와 제한
다섯 가지 Nano Banana 모델을 모두 비교하려면 Nano Banana 개요를 참고하세요.
Nano Banana 2.1과 Nano Banana 2 중 무엇을 쓸까요?
두 모델은 같은 요청을 받고 같은 형태로 응답하므로, 전환할 때는 모델 ID만 바꾸면 됩니다.신규 프로젝트: Nano Banana 2.1
1K~4K를 더 낮은 호출당 가격에 제공하며, 텍스트와 레이아웃이 더 좋습니다.
512px 미리보기: Nano Banana 2
Nano Banana 2.1에는
512 크기가 없습니다. Nano Banana 2는 같은 가격으로 계속 제공되므로 기존 연동을 옮기지 않아도 됩니다.
Nano Banana 2.1, 2K, 16:9: 25초, $0.045

Nano Banana 2, 2K, 16:9: 21초, $0.055
호출 전 준비
1
API 키 발급
토큰 관리에서
default 그룹의 키를 만들고 과금 방식(计费模式)을 사용량 우선(按量优先, 권장) 또는 건당 과금(按次计费)으로 설정합니다. 사용량 과금(按量计费) 키는 Nano Banana 2.1 같은 건당 과금 모델을 호출할 수 없습니다.2
키 설정과 의존성 설치
3
cURL용 저장 함수 추가
cURL 예제에는 응답에 이미지가 없으면 이 함수는 대신
jq가 필요합니다. 아래 셸 함수는 Gemini 네이티브 응답에서 사고용이 아닌 마지막 이미지를 mimeType에 맞는 확장자로 저장합니다.error, promptFeedback, finishReason 필드를 출력합니다.
예제는 300초까지 기다리도록 설정했으며, 클라이언트와 중간 프록시에도 같은 여유를 두세요. 가끔 이 제한을 넘기는 요청이 있으므로, 타임아웃이 난 요청을 다시 보내기 전에 호출 로그를 확인하세요.
이미지 생성
- cURL
- Python
candidates[0].content.parts[].inlineData.data에 Base64로 들어 있고, 형식은 mimeType으로 알 수 있습니다. 두 예제 모두 이를 디코딩해 형식에 맞는 PNG, JPEG, WebP 파일로 저장합니다.
aspectRatio를 생략하면 모델이 프롬프트를 보고 프레임을 정합니다. 1:1과 16:9의 출력 픽셀은 위 호출 전 준비 절의 표에 있고, 다른 종횡비는 Google의 이미지 생성 가이드에서 확인하세요.
이미지 편집
지시문을 먼저 보내고, 참조 이미지를inlineData 파트로 이어서 보냅니다. 프롬프트에서는 이미지를 순서대로 “첫 번째 이미지”, “두 번째 이미지”처럼 가리키세요. Nano Banana 2.1은 참조 이미지를 최대 14장 받으며, 객체 이미지는 최대 10장, 캐릭터 이미지는 최대 4장입니다.
- cURL
- Python
로컬 파일 두 개를 합성하는 요청입니다. 큰 이미지가 셸 인자 길이 제한을 넘지 않도록
jq로 본문을 만들고, 각 mimeType이 파일과 일치하는지 확인하세요.큰 이미지는 URL로 전달
요청 본문 전체를 20MB 이내로 유지하세요. 참조 이미지가 크거나 이미 CDN에 있다면 내려받아 인코딩하는 대신fileData 파트에 URL을 넣어 전달합니다.
https://cdn.example.com/your-photo.jpg는 실제 이미지 URL로 바꾸고,mimeType을 이미지 형식에 맞추세요.fileData파트와inlineData파트는 같은parts배열에 함께 쓸 수 있으며, 나열한 순서대로 첫 번째, 두 번째 이후의 참조 이미지로 계산됩니다.- 서버가 이미지를 내려받으므로 URL은 로그인 없이 접근할 수 있어야 합니다. 전체 조건은 Nano Banana 개요의 큰 이미지와 이미지 URL 절을 참고하세요.
Google 검색으로 이미지 그라운딩
이미지가 최신 정보나 실제 랜드마크의 모습에 의존한다면googleSearch 도구를 추가하세요. 아래 요청은 웹 검색과 이미지 검색을 모두 켜고, 모델이 쓴 텍스트도 함께 받도록 TEXT를 허용합니다.
searchTypes는 객체여야 합니다. 생략하면 웹 검색만 사용하고,imageSearch만 쓰면 이미지 검색만 사용합니다.- 검색할지, 어떤 유형으로 검색할지는 모델이 정합니다. 실행한 쿼리는
groundingMetadata에 나옵니다. - 이미지 검색은 현재 실제 인물 이미지를 참조로 쓸 수 없습니다.
- 그라운딩 결과를 최종 사용자에게 보여 준다면, Google의 그라운딩 가이드가 요구하는 대로 검색 제안을 표시하세요.
- 검색 1회마다 호출 가격 $0.045에 $0.014가 더해지므로, 검색을 2회 실행한 요청은 $0.073입니다. 호출 로그에서 검색 횟수를 볼 수 있으며, 자세한 규칙은 Nano Banana 개요의 과금 절을 참고하세요.
OpenAI 호환 경로 사용
앱이 이미 OpenAI SDK를 쓴다면base_url을 https://api.laozhang.ai/v1로, model을 gemini-nano-banana-2.1로 지정하세요. 이 경로에는 종횡비, 크기, 형식 설정이 없습니다. 프롬프트에 따라 모델이 프레임을 정한 1K PNG를 반환하며, 16:9인 경우가 많습니다. 종횡비를 고정하거나 2K·4K, JPEG가 필요하면 Gemini 네이티브 경로를 쓰세요.
이미지는 message.content 안에 Base64 데이터 URL로 들어옵니다. 아래 스크립트를 nano_banana_21_chat.py로 저장하세요.
오류와 과금
잘못된 파라미터는 HTTP 400을 반환하며 과금되지 않습니다. 14가지 종횡비에 없는aspectRatio(예: 7:3)는 오류 메시지가 비어 있을 수 있는 400을 반환하므로, 위 파라미터와 제한 표에서 종횡비를 확인하세요. 요청 본문이 너무 크면 413이 반환됩니다. 큰 이미지는 위 큰 이미지는 URL로 전달 절처럼 URL로 넘기세요.
- 출력 크기, 사고 수준, 참조 이미지 수, 생성·편집 여부와 관계없이 호출당 $0.045입니다.
- Google 검색 그라운딩은 검색 1회당 $0.014가 추가됩니다.
- 프롬프트가 이미지를 요청하지 않았거나 안전 검사가 출력을 차단한 경우처럼, 이미지 없이 HTTP 200이 반환될 수 있습니다. 이때도 한 번 과금됩니다.
finishReason을 확인하고 프롬프트나 참조 이미지를 바꾼 뒤 다시 보내세요. Nano Banana 개요의 빈 응답 과금 피하기 절을 참고하세요. - 429와 5xx 응답은 백오프를 두고 재시도하고, 타임아웃이 난 요청은 다시 보내기 전에 호출 로그를 확인하세요.
자주 묻는 질문
Nano Banana 2에서 옮기려면 무엇을 바꾸나요?
모델 ID를gemini-3.1-flash-image에서 gemini-nano-banana-2.1로 바꾸면 됩니다. 요청과 응답은 그대로입니다. 그다음 두 가지를 확인하세요.
"imageSize": "512"를 쓰던 요청은1K로 바꾸거나 Nano Banana 2에 그대로 두세요. Nano Banana 2.1은 이 요청에 1K 이미지를 반환하고 호출을 과금합니다.thinkingLevel을 지정하지 않으면 Nano Banana 2.1은medium으로, Nano Banana 2는 기본값인minimal로 사고합니다. 더 빠른 동작을 원하면minimal을 명시하세요.
사고 수준은 어떻게 바꾸나요? 가격에 영향이 있나요?
Gemini 네이티브 경로에서generationConfig.thinkingConfig.thinkingLevel을 minimal, medium, high 중 하나로 설정합니다. 수준이 높을수록 레이아웃과 텍스트에 더 많은 노력을 들이고 시간이 더 걸립니다.
"includeThoughts": true도 함께 설정하면 응답에 "thought": true로 표시된 사고 텍스트와 초안 이미지가 추가됩니다. save_image 함수와 Python 스크립트는 이를 건너뜁니다.
4K가 1K보다 비싼가요?
아니요. 모든 호출이 $0.045입니다. 2026년 10월 7일과 14일에 1K, 2K, 4K로 직접 호출해 본 결과 모두 이 금액으로 기록되었습니다. Google은 출력 토큰 기준으로 과금하며, 가격 페이지에 따르면 4K 이미지 한 장이 약 $0.113입니다. 1K 이미지만 필요하다면 Nano Banana 2 Lite가 호출당 더 저렴합니다.Nano Banana 2.1과 Nano Banana Pro 중 무엇을 쓸까요?
호출당 $0.045인 Nano Banana 2.1로 시작하세요. 이미지가 세계 지식, 다국어 텍스트, 정확한 브랜드 디테일에 의존하거나, 편집에 스타일 참조와 최대 5장의 캐릭터 참조가 필요하다면 Nano Banana Pro(gemini-3-pro-image, 호출당 $0.09)로 옮기세요. 두 모델은 같은 요청을 받으므로, 결정하기 전에 직접 쓰는 프롬프트로 두 모델을 모두 시험해 보세요.
2026년 10월 14일에 같은 프롬프트를 2K, 16:9로 실행했을 때 Nano Banana 2.1은 25초, Nano Banana Pro는 69초가 걸렸습니다.

Nano Banana 2.1, 2K, 16:9: 25초, $0.045

Nano Banana Pro, 2K, 16:9: 69초, $0.09
Google 계정이나 AI Studio 키가 필요한가요?
아니요.default 그룹의 LaoZhang API 키면 충분합니다. 이 페이지의 Gemini 네이티브 형식이나 OpenAI 호환 형식으로 https://api.laozhang.ai에 요청을 보내면 됩니다.
요청이 실패하거나 이미지가 없으면 과금되나요?
잘못된 파라미터로 인한 400이나 생성 전에 발생한 429·5xx처럼 업스트림이 200이 아닌 응답을 반환하면 과금되지 않습니다. HTTP 200은 이미지 유무와 관계없이 한 번 과금됩니다. 위 오류와 과금 절과 과금과 실패 처리를 참고하세요.JPEG로 출력할 수 있나요?
네. Gemini 네이티브 경로에서generationConfig.imageConfig에 imageOutputOptions를 추가하세요.
mimeType은image/png(기본값)와image/jpeg를 받습니다.image/webp는 400을 반환하며 과금되지 않습니다.compressionQuality는 JPEG에만 적용되며 0~100 범위입니다. 값이 낮을수록 파일이 작아집니다.- 응답의
inlineData.mimeType이image/jpeg로 바뀝니다. 같은 1K 정사각형 이미지가 PNG로는 약 1.1MB, JPEG로는 40~60KB이며 가격은 같습니다. - OpenAI 호환 경로에서는 형식을 지정할 수 없고 항상 PNG를 반환합니다.
OpenAI 호환 경로가 가로형 이미지를 반환하는 이유는 무엇인가요?
이 경로는 종횡비를 전달할 수 없어서, 모델이 프롬프트를 보고 프레임을 정하며 16:9인 경우가 많습니다. 정사각형이나 세로형이 필요하면 Gemini 네이티브 경로에서aspectRatio를 지정하세요.
관련 페이지와 출처
- Nano Banana 개요 — 5종 모델, 두 프로토콜, 과금 비교
- Nano Banana 2 — 512px 출력이 필요할 때
- Nano Banana 2 Lite — 저비용 1K 이미지
- Nano Banana Pro — 복잡한 레이아웃과 브랜드 핵심 에셋
- Gemini 프로토콜 — 네이티브 요청 구조와 SDK 설정
- Google: Gemini Nano Banana 2.1 — 공식 기능과 제한
- Google: Nano Banana image generation — 크기, 종횡비, 참조 이미지 제한
- 호출 로그 — 요청별 상태와 청구 금액 확인