Nano Banana 시리즈
Google의 Gemini 이미지 모델로, 모두 다섯 가지입니다. 비율과 해상도를 정밀하게 제어할 수 있는 Gemini 네이티브 API로 호출하는 것을 권장합니다. OpenAI 호환 API도 사용할 수 있지만 일부 파라미터만 지원합니다.
주요 작업
모델 선택
- 1K, 2K, 4K 3단계
- 1:8 ~ 8:1 비율 지원. 2K, 4K는 실측 약 2분
- 512 ~ 4K 4단계 해상도
- 가장 많은 비율 지원, 1:8과 8:1 포함
- 1K, 2K, 4K 3단계
- 생성 전에 먼저 reasoning을 수행하므로 시간이 더 걸림
- 1K만 지원
- 실측 장당 약 5초, JPEG 출력
- 약 1K 고정, 해상도 지정 불가
- 기존 프로젝트에서 계속 사용 가능
google/gemini-nano-banana-2.1최신google/gemini-3.1-flash-image일상 용도 추천google/gemini-3-pro-image4K, 복잡한 구도google/gemini-3.1-flash-lite-image1K만 지원google/gemini-2.5-flash-image이전 세대실시간 가격은 모델 페이지를 참고하십시오: Nano Banana 2 , Nano Banana Pro . 실제 청구액은 응답의 usageMetadata를 따릅니다.
엔드포인트 선택
지연 시간과 타임아웃
API는 동기 방식입니다. 실측 결과 1K는 약 5~20초, 4K는 약 30초가 걸렸고, Nano Banana 2.1의 2K, 4K는 약 2분이 걸렸습니다. 사용량이 많은 시간대에는 더 오래 걸립니다. Pro는 이미지를 생성하기 전에 먼저 reasoning을 수행하므로(응답에 thoughtsTokenCount 포함) 같은 해상도의 Nano Banana 2보다 시간이 더 걸립니다. 흔히 쓰이는 60초 기본 타임아웃으로는 4K 요청과 혼잡 시간대 요청을 감당할 수 없으며, 클라이언트가 연결을 끊어도 요청은 과금됩니다.
응답 구조
{
"candidates": [{
"content": {
"parts": [{ "inlineData": { "mimeType": "image/png", "data": "iVBORw0KGgo…" } }],
"role": "model"
},
"finishReason": "STOP"
}],
"modelVersion": "google/gemini-3-pro-image",
"usageMetadata": {
"promptTokenCount": 7,
"candidatesTokenCount": 2000,
"candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 2000 }],
"thoughtsTokenCount": 211,
"totalTokenCount": 2218
}
}- 이미지는
parts중inlineData가 있는 항목에 담기며, 첫 번째 항목이라는 보장은 없습니다. 앞에 텍스트가 있을 수 있으므로parts를 순회하여 찾으십시오. candidatesTokensDetails의IMAGE항목 수치가 출력 이미지의 토큰 수입니다. 실측 결과 1K는 1,120, Pro의 4K는 2,000이었습니다.thoughtsTokenCount는 Pro의 응답에만 나타나며, 이미지 생성 전 reasoning에 사용된 토큰을 나타냅니다.
공식 문서
공식 문서는 Google에 직접 연결할 때의 동작을 설명합니다. OfoxAI를 통해 호출할 때는 이 페이지의 실측 결과를 기준으로 하십시오.
자주 묻는 질문
Nano Banana Pro로 4K 이미지를 생성하려면 어떻게 합니까?
Gemini 네이티브 API를 사용하여 generationConfig.imageConfig에 imageSize: "4K"를 전달하고, aspectRatio로 비율을 지정하십시오. 실측 결과 16:9의 4K 출력은 5504x3072, 약 16 MB이며 약 33초가 걸렸습니다. OpenAI 호환 API는 imageSize를 지원하지 않으며, image_size를 전달하면 400이 반환됩니다.
Nano Banana 2는 어떤 비율을 지원합니까?
자주 쓰이는 10가지(1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9)와 함께 초광폭 또는 초장형 비율 4가지(1:4, 4:1, 1:8, 8:1)를 지원합니다. 목록에 없는 비율은 400 Request contains an invalid argument가 반환됩니다.
Nano Banana Pro는 1:8이나 4:1을 지원합니까?
지원하지 않습니다. 1:4, 4:1, 1:8, 8:1 네 가지 비율은 Nano Banana 2.1, Nano Banana 2, Nano Banana 2 Lite만 지원하므로, 매우 길거나 넓은 이미지가 필요하면 이 세 모델을 사용하십시오.
imageSize는 4K와 4k 중 어떻게 써야 합니까?
Google 공식 문서와 같이 대문자 1K, 2K, 4K를 권장합니다. 실측 결과 OfoxAI는 소문자도 받습니다. 512 단계에는 K를 붙이지 않으며, Nano Banana 2만 지원합니다.
OpenAI 호환 API로 Nano Banana의 비율을 지정하려면 어떻게 합니까?
최상위 aspect_ratio를 사용하십시오(예: "16:9"). 이 API는 해상도 파라미터를 지원하지 않으므로, 2K나 4K가 필요하면 Gemini 네이티브 API의 imageConfig.imageSize를 사용하십시오.
Nano Banana는 한 번에 여러 장을 생성할 수 있습니까?
아니요, 요청당 한 장을 생성합니다. 여러 장이 필요하면 요청을 여러 번 동시에 보내되 rate limit에 유의하십시오.
Nano Banana의 타임아웃은 얼마로 설정하는 것이 좋습니까?
300초 이상을 권장합니다. 실측 결과 1K는 약 5~20초, 4K는 약 30초, Nano Banana 2.1의 2K, 4K는 약 2분이 걸렸으며, 혼잡 시간대에는 더 오래 걸립니다. Pro는 생성 전에 먼저 reasoning을 수행하므로 Nano Banana 2보다 시간이 더 걸립니다.