> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nano Banana 2 이미지 생성/편집

> Google의 최신 이미지 생성 모델 Nano Banana 2 (gemini-3.1-flash-image-preview) - Flash급 속도로 Pro 수준의 품질, 4K 출력, 14개 화면 비율, Image Search Grounding, 호출당 $0.055/image, token 기반으로 $0.025/image부터.

## 개요

**Nano Banana 2** (코드명)는 2026년 2월 26일에 출시된 Google의 최신 이미지 생성 모델로, 모델 ID는 `gemini-3.1-flash-image-preview`입니다. **Pro급 품질에 Flash급 속도와 비용**으로 이미지 생성의 비용 효율성을 재정의하며, Nano Banana 시리즈의 최신 플래그십입니다.

<Note>
  **🔥 2026년 2월 26일 출시**: Nano Banana 2를 지금 사용할 수 있습니다! Pro급 품질, Flash급 속도, Google 요금의 최대 36% 수준인 token 기반 과금! 512px는 이미지당 단 \$0.025부터입니다! 4K 출력, 14개 종횡비, 이미지 검색 그라운딩 등 더 많은 독점 기능을 지원합니다.
</Note>

<Note>
  **🆕 2026년 5월 29일 업데이트 (`-preview` 삭제됨)**: Google이 공식 문서를 업데이트하고 안정판 모델 이름 **`gemini-3.1-flash-image`**(`-preview` 없음)을 출시했습니다. APIYI는 이미 이를 지원합니다.

  * **기존 이름도 계속 작동합니다**: `gemini-3.1-flash-image-preview`는 이전과 같이 계속 작동하며, **과금은 변경되지 않으며**, 코드 변경이 필요하지 않습니다.
  * **두 이름 모두 사용 가능합니다**: 새 `gemini-3.1-flash-image` 이름 또는 원래 `-preview` 이름을 모두 사용할 수 있습니다.

  참고: Google은 안정판 버전이 미리보기 버전과 출력 품질, 안전 필터링 또는 기타 동작에서 다른지 명확히 밝히지 않았습니다. 직접 테스트해 보고 피드백을 공유해 주시기 바랍니다.
</Note>

<Info>
  모든 image API는 **동기식**입니다. 대기할 task ID가 없으며, 클라이언트 연결이 끊기면 요청은 과금된 상태로 유지되지만 결과는 사라집니다. 이 모델에는 넉넉한 timeout을 설정하십시오. [이미지 API 필수 사항 및 모범 사례](/ko/api-capabilities/image-api-best-practices)를 참조하십시오.
</Info>

<CardGroup cols={2}>
  <Card title="텍스트-이미지 API" icon="wand-sparkles" href="/ko/api-capabilities/nano-banana-2-image/text-to-image">
    텍스트 prompt로 이미지를 생성합니다. 온라인 테스트용 대화형 플레이그라운드가 포함되어 있습니다.
  </Card>

  <Card title="이미지 편집 API" icon="image" href="/ko/api-capabilities/nano-banana-2-image/image-edit">
    이미지 + 편집 지시사항을 업로드하여 새 이미지를 생성합니다. 대화형 플레이그라운드가 포함되어 있습니다.
  </Card>
</CardGroup>

## APIYI의 Nano Banana 2를 선택해야 하는 이유는 무엇입니까?

**Nano Banana Pro / 2는 APIYI에서 사용량 기준 1위 모델입니다** — 안정적이고 신뢰할 수 있으며 빠릅니다. 전문 팀과 함께 일하고 싶으시다면 APIYI가 올바른 선택입니다.

막 출시된 Google 플래그십은 공급원 측에서 여전히 용량 제약이 있지만 — APIYI는 **신뢰성**, **비용**, **통합** 전반에서 경험을 깊이 최적화합니다:

<CardGroup cols={2}>
  <Card title="공식 채널 · Gemini와 동일" icon="shield-check">
    Google의 기본 Gemini API(`/v1beta/models/.../generateContent`) 및 OpenAI SDK 패턴과 100% 호환됩니다 — 요청 본문, 응답 필드, 오류 코드가 동일합니다. 코드 수정 없는 마이그레이션이 가능합니다.
  </Card>

  <Card title="동시 실행 수 제한 없음" icon="infinity">
    Google AI Studio의 RPM/RPD 상한에 구애받지 않습니다. 엔터프라이즈 규모의 배치 생성과 피크 트래픽도 쿼터 중단 없이 선형적으로 확장됩니다.
  </Card>

  <Card title="Google 정가의 28-36%" icon="percent">
    호출당 \$0.055/image(대비 Google \$0.151), 512px는 token 기반으로 \$0.025/image부터(대비 \$0.045). [충전 보너스](/ko/faq/recharge-promotions)와 함께 적용하면 정가의 30.3% 수준까지 내려갑니다.
  </Card>

  <Card title="글로벌 무장벽 접근" icon="globe">
    **해외 서버나 프록시가 필요하지 않습니다** — 중국 본토 데이터 센터, 가정용 네트워크 또는 해외 노드에서 `api.apiyi.com`에 직접 연결할 수 있습니다. 안정적인 지연 시간, 국경 간 재구성 불필요.
  </Card>

  <Card title="전체 모델 라인업" icon="layers">
    동일한 시리즈로 [Nano Banana Pro](/ko/api-capabilities/nano-banana-image/overview)(최고 품질), Nano Banana 2(최고 가성비), 그리고 기존 Nano Banana를 모두 제공합니다 — 상황에 맞게 혼합해 사용할 수 있습니다.
  </Card>

  <Card title="전문 엔터프라이즈 지원" icon="handshake">
    저희 팀은 프로덕션 이미지 생성 배포를 전문으로 하며, 모델 선택, 튜닝, 통합에 대한 깊은 경험을 보유하고 있습니다 — PoC부터 프로덕션까지 end-to-end 지원을 제공합니다.
  </Card>
</CardGroup>

## 핵심 기능

<CardGroup cols={2}>
  <Card title="프로급 품질" icon="sparkles">
    생동감 있는 조명, 풍부한 질감, 선명한 디테일 - 훨씬 더 빠른 속도로 Nano Banana Pro에 견줄 만한 품질
  </Card>

  <Card title="4K 울트라 HD 출력" icon="expand">
    512px, 1K, 2K, 4K 해상도를 지원하며 최대 4096×4096까지 가능합니다
  </Card>

  <Card title="14개 화면 비율" icon="maximize">
    새로 추가된 항목: 1:4, 4:1, 1:8, 8:1 - 총 14개 화면 비율로 더 다양한 사용 사례를 지원합니다
  </Card>

  <Card title="이미지 검색 그라운딩" icon="search">
    Nano Banana 2 전용 - Google 이미지 검색에서 시각적 컨텍스트를 가져옵니다
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="정확한 텍스트 렌더링" icon="type">
    다국어 지원으로 이미지 속 텍스트를 선명하고 읽기 쉽게 렌더링하며 - 포스터와 마케팅 자료에 적합합니다
  </Card>

  <Card title="멀티턴 편집" icon="message-circle">
    채팅을 통해 반복적으로 다듬는 대화형 이미지 편집
  </Card>

  <Card title="추론 모드" icon="brain">
    복잡한 prompt를 더 정밀하게 처리할 수 있도록 최소 또는 높은 추론 수준을 설정할 수 있습니다
  </Card>

  <Card title="피사체 일관성" icon="users">
    최대 5개의 캐릭터와 14개의 참조 객체 전반에서 유사성을 유지합니다
  </Card>
</CardGroup>

## 버전 비교

| Feature                | **Nano Banana 2**                | Nano Banana Pro              | Nano Banana              |
| ---------------------- | -------------------------------- | ---------------------------- | ------------------------ |
| Model ID               | `gemini-3.1-flash-image-preview` | `gemini-3-pro-image-preview` | `gemini-2.5-flash-image` |
| Quality                | ⭐⭐⭐⭐⭐ Pro 수준                     | ⭐⭐⭐⭐⭐ 최고                     | ⭐⭐⭐⭐ 우수                  |
| Speed                  | 🚀 가장 빠름                         | 🐢 더 느림                      | ⚡ 빠름                     |
| Max Resolution         | 4K                               | 4K                           | 1K                       |
| Aspect Ratios          | 14                               | 10                           | 10                       |
| Image Search Grounding | ✅ 독점                             | ❌                            | ❌                        |
| APIYI 요금               | **\$0.055/image(호출당)**           | \$0.09/image                 | \$0.02/image             |
| Status                 | 프리뷰                              | 프리뷰                          | 정식 출시                    |

<Tip>
  **선택 가이드**:

  * 🔥 **최고 가성비** → Nano Banana 2 (토큰 기반, \$0.025/image부터, Pro 수준 품질 + Flash급 속도)
  * 🎨 **최고 품질** → Nano Banana Pro (\$0.09/image, 최고 수준의 사실감)
  * ⚡ **최저 비용** → Nano Banana (\$0.025/image, 빠르고 안정적)
</Tip>

## 가격

<Info>
  **과금 방식 선택**: Nano Banana 2는 두 가지 과금 방식을 지원하며, API token을 생성할 때 “Billing model” 설정에서 선택합니다:

  * **Pay-as-you-go** 또는 **Pay-as-you-go Priority** 선택 → token 기반 과금
  * **Pay-per-request** 또는 **Pay-per-request Priority** 선택 → 호출당 과금(Nano Banana Pro와 동일)
  * ⚠️ **Hybrid billing은 선택하지 마십시오**
</Info>

### 호출당 과금

| 모델                                                 | APIYI 가격          | Google 공식 4K          | 할인              |
| -------------------------------------------------- | ----------------- | --------------------- | --------------- |
| **Nano Banana 2** `gemini-3.1-flash-image-preview` | **\$0.055/image** | \$0.151/image         | **🔥 약 64% 할인** |
| Nano Banana Pro `gemini-3-pro-image-preview`       | \$0.09/image      | \$0.24/image          | **약 63% 할인**    |
| Nano Banana `gemini-2.5-flash-image`               | \$0.02/image      | \$0.039/image (1K 전용) | 약 50% 할인        |

<Tip>
  **엔터프라이즈 HA 채널**: NanoBananaEnterprise는 표준 Nano Banana Pro 요율의 1.4배(\$0.126/image)로 제공되며, 엔터프라이즈 워크로드를 위한 전용 고가용성 폴백을 제공합니다.
</Tip>

### token 기반 과금 (Nano Banana 2 전용)

| 과금 항목           | Google 공식               | APIYI           | 할인      |
| --------------- | ----------------------- | --------------- | ------- |
| 입력              | \$0.50/M tokens         | \$0.18/M tokens | **36%** |
| 출력(이미지와 텍스트 통합) | 이미지 \$60/M, 텍스트 \$1.5/M | \$21.6/M tokens | **36%** |

### token 기반 과금 가격 추정치

| 해상도   | Google 공식 | APIYI         | Fal AI |
| ----- | --------- | ------------- | ------ |
| 512px | \$0.045   | **약 \$0.025** | \$0.06 |
| 1K    | \$0.067   | **약 \$0.035** | \$0.08 |
| 2K    | \$0.101   | **약 \$0.045** | \$0.12 |
| 4K    | \$0.151   | **약 \$0.07**  | \$0.16 |

<Tip>
  **💰 token 기반 과금이 더 많이 절약됩니다!** token 기반 과금을 사용하면 512px 이미지를 단 \$0.025에 이용할 수 있으며, 이는 Google 요금의 36%에 불과합니다! 저해상도 사용 사례에서는 호출당 과금(\$0.055/image)보다 훨씬 저렴합니다. 4K의 경우 token 기반 가격(\~\$0.07)도 호출당 과금보다 더 저렴하며, 두 방식 모두 Google 공식 \$0.151/image보다 훨씬 낮습니다. 충전 보너스와 결합하면 실제 비용은 더욱 낮아집니다.
</Tip>

## 그룹 설정

Nano Banana 2는 APIYI에서 두 개의 그룹과 함께 제공됩니다. 대시보드 → **Token 설정**에서 전환합니다:

| 그룹                     | 요율   | 사용 시점                                            |
| ---------------------- | ---- | ------------------------------------------------ |
| `Default`              | 1.0x | 기본 라인, 가격표와 일치합니다; 권장 기본값입니다                     |
| `NanoBananaEnterprise` | 1.4x | 백업 라인 — 기본값이 빡빡하거나 타임아웃이 급증할 때 수동으로 전환합니다, 용량 우선 |

**왜 1.4x입니까?** 1.4x여도 가격은 여전히 Google 정가의 약 50% 수준이며 — 공식 가격보다 훨씬 낮습니다. 이는 더 높은 동시 실행 수의 워크로드와 예기치 않은 업스트림 리스크 제어 이벤트를 위한 백업 라인으로, 엔터프라이즈 고객에게 고가용성 보장을 제공합니다. 기본 그룹이 빡빡할 때는 Token을 `NanoBananaEnterprise`로 전환하여 급증을 버티십시오.

**권장 과금 모델**: `Pay-as-you-go Priority`를 선택하십시오 — Nano Banana 2의 token 기반 과금과 Nano Banana Pro의 호출당 과금을 모두 포함하며, **시리즈 전체를 위한 하나의 Token**입니다.

<Frame caption="Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)">
  <img src="https://mintcdn.com/apiyillc/EyWjOyg5fLaMGReJ/images/nano-banana-enterprise-token-setup-20260506.png?fit=max&auto=format&n=EyWjOyg5fLaMGReJ&q=85&s=cf85cd8ddaaa541ebbd970a52a98c68f" alt="Token 생성 UI: 과금 모델 'Pay-as-you-go Priority'는 NB2 token 기반 과금 + NB Pro 호출당 과금을 포함합니다; 기본 그룹 Default + 백업 그룹 NanoBananaEnterprise (1.4x 라인)" width="1270" height="1052" data-path="images/nano-banana-enterprise-token-setup-20260506.png" />
</Frame>

<Tip>
  **더 나아가면**: Token이 GPT-image-2와 같은 다른 이미지 모델도 포함한다면, 더 안정적인 `Default`를 기본 그룹으로 유지하고 `NanoBananaEnterprise`을 백업 슬롯에 두십시오 — 기본 그룹의 429는 token 교체 없이 자동으로 엔터프라이즈 그룹으로 페일오버됩니다.
</Tip>

## 지원되는 해상도 및 종횡비

### 출력 해상도

| 해상도   | 설명   | 권장 용도           |
| ----- | ---- | --------------- |
| 512px | 저해상도 | 썸네일, 빠른 미리보기    |
| 1K    | 기본값  | 소셜 미디어, 웹 표시    |
| 2K    | 고화질  | HD 디스플레이, 인쇄 자료 |
| 4K    | 초고화질 | 전문 디자인, 상업용 포스터 |

### 지원되는 종횡비 (총 14개)

`1:1`, `1:4`, `4:1`, `1:8`, `8:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`

### 종횡비별 출력 크기(픽셀)

아래 표는 Google 공식 문서를 바탕으로 512px / 1K / 2K / 4K 해상도 티어 전반에서 Nano Banana 2의 실제 출력 크기를 나열합니다. 요청에서는 비율에 `aspect_ratio`를, 티어에 `image_size`(또는 `resolution`)를 설정하십시오:

| 종횡비      | 512px    | 1K        | 2K        | 4K         |
| -------- | -------- | --------- | --------- | ---------- |
| **1:1**  | 512×512  | 1024×1024 | 2048×2048 | 4096×4096  |
| **1:4**  | 256×1024 | 512×2048  | 1024×4096 | 2048×8192  |
| **1:8**  | 192×1536 | 384×3072  | 768×6144  | 1536×12288 |
| **2:3**  | 424×632  | 848×1264  | 1696×2528 | 3392×5056  |
| **3:2**  | 632×424  | 1264×848  | 2528×1696 | 5056×3392  |
| **3:4**  | 448×600  | 896×1200  | 1792×2400 | 3584×4800  |
| **4:1**  | 1024×256 | 2048×512  | 4096×1024 | 8192×2048  |
| **4:3**  | 600×448  | 1200×896  | 2400×1792 | 4800×3584  |
| **4:5**  | 464×576  | 928×1152  | 1856×2304 | 3712×4608  |
| **5:4**  | 576×464  | 1152×928  | 2304×1856 | 4608×3712  |
| **8:1**  | 1536×192 | 3072×384  | 6144×768  | 12288×1536 |
| **9:16** | 384×688  | 768×1376  | 1536×2752 | 3072×5504  |
| **16:9** | 688×384  | 1376×768  | 2752×1536 | 5504×3072  |
| **21:9** | 792×168  | 1584×672  | 3168×1344 | 6336×2688  |

<Info>
  Nano Banana Pro의 10개 종횡비와 비교하면, Nano Banana 2는 `1:4`, `4:1`, `1:8`, `8:1`를 추가합니다. 이는 장문형 이미지와 인포그래픽에 이상적인 초세로형/초가로형 비율입니다. 또한 512px 저해상도 티어를 지원하는 유일한 모델로, 썸네일과 빠른 미리보기에 매우 적합합니다.
</Info>

## 자주 묻는 질문

<AccordionGroup>
  <Accordion title="Nano Banana 2와 Nano Banana Pro의 차이점은 무엇입니까?">
    **Nano Banana 2** (`gemini-3.1-flash-image-preview`)는 Gemini 3.1 Flash를 기반으로 하고, **Nano Banana Pro** (`gemini-3-pro-image-preview`)는 Gemini 3 Pro를 기반으로 합니다. 주요 차이점은 다음과 같습니다:

    * ✅ **속도**: Nano Banana 2가 더 빠릅니다(Flash급 속도)
    * ✅ **가격**: Nano Banana 2의 token 기반 과금이 더 저렴합니다(\$0.025부터 vs \$0.09)
    * ✅ **종횡비**: Nano Banana 2는 14개를 지원합니다(4개 더 많음)
    * ✅ **이미지 검색 그라운딩**: Nano Banana 2 전용입니다
    * ⚠️ **최종 품질**: Nano Banana Pro가 여전히 약간 더 좋습니다
  </Accordion>

  <Accordion title="Nano Banana Pro에서 Nano Banana 2로 바꾸어야 합니까?">
    **추천합니다!** Nano Banana 2는 더 낮은 가격과 더 빠른 속도로 Pro에 가까운 품질을 제공합니다. 극단적인 품질 요구가 없다면 Nano Banana 2가 더 나은 선택입니다.

    모델 이름을 `gemini-3-pro-image-preview`에서 `gemini-3.1-flash-image-preview`로 바꾸기만 하면 됩니다.
  </Accordion>

  <Accordion title="gemini-3.1-flash-image-preview와 -4k 접미사 버전 중 어느 것을 사용해야 합니까?">
    **코드 / API 호출에는 항상 일반 모델 이름 `gemini-3.1-flash-image-preview`(`-4k` 접미사 없음)을 사용하고, `gemini-3.1-flash-image-preview-4k`는 사용하지 않는 것을 권장합니다.**

    * **공식 이름에는 `-4k`가 없습니다**: Google의 공식 모델 이름은 `gemini-3.1-flash-image-preview`입니다. 또한 이 모델은 우리가 유지보수에 가장 많은 리소스를 투입하는 일반 채널이므로, 안정성과 호환성이 가장 좋습니다.
    * **`-4k`의 유래**: `gemini-3.1-flash-image-preview-4k`은 Chatbox 같은 대화형 클라이언트의 'chat-to-image' 시나리오를 위해 원래 준비된 설정이었습니다. 즉, 메시징 UI에서 채팅을 통해 직접 이미지를 생성하는 방식입니다.
    * **코드 + Gemini 네이티브 형식은 일반 이름을 더 선호합니다**: 코드로 Gemini 네이티브 형식(`/v1beta/models/.../generateContent`)을 사용할 경우, 일반 모델 이름 `gemini-3.1-flash-image-preview`이 더 안정적입니다.

    4K 출력을 필요로 할 때는 `-4k` 모델 이름에 의존할 필요가 없습니다. 요청 매개변수에서 4K 해상도를 지정하기만 하면 됩니다(위의 '지원되는 해상도 및 종횡비' 참고).
  </Accordion>

  <Accordion title="Image Search Grounding이란 무엇입니까?">
    Image Search Grounding은 Nano Banana 2 전용 기능입니다. Google Image Search에서 시각적 컨텍스트를 가져와 실제 대상과 더 잘 맞는 이미지를 생성합니다. 예를 들어 실제 랜드마크 이미지를 생성할 때 검색 결과를 참조하여 정확도를 높일 수 있습니다.
  </Accordion>

  <Accordion title="Thinking Mode는 무엇을 합니까?">
    Thinking Mode는 모델이 이미지를 생성하기 전에 추론하고 분석할 수 있게 하여, 복잡한 prompt의 정확도를 높입니다. `high`로 설정하면 가장 좋은 결과를 얻을 수 있지만 생성 시간이 약간 늘어납니다. 정밀한 구도, 텍스트 렌더링, 복잡한 장면이 필요한 작업에 가장 적합합니다.
  </Accordion>

  <Accordion title="이미지 생성에는 얼마나 걸립니까?">
    생성 시간은 해상도와 thinking mode에 따라 달라집니다:

    * **1K 해상도**: 약 5\~10초
    * **2K 해상도**: 약 10\~15초
    * **4K 해상도**: 약 15\~25초
    * 높은 thinking mode를 활성화하면 몇 초가 더 추가됩니다

    간헐적인 지연과 피크 혼잡을 대비해 더 긴 timeout(최소 360초) 설정을 권장합니다.
  </Accordion>

  <Accordion title="동시 실행 수 제한이 있습니까? API는 직렬 처리입니까? 20명의 사용자가 동시에 호출해야 하면 어떻게 합니까?">
    **API에는 동시 실행 수 제한이 없고 직렬로 처리되지도 않습니다.** 직접 동시 요청을 안전하게 보낼 수 있으며, 요청은 서로 큐잉되거나 차단되지 않습니다. 20명의 사용자가 동시에 호출하더라도 20개의 동시 요청을 보내면 됩니다. 추가 쿼터 요청이나 스로틀링은 필요 없습니다.

    Google AI Studio와 달리 APIYI 채널에는 엄격한 RPM/RPD 제한이 없으므로, 엔터프라이즈 배치 생성과 피크 트래픽이 선형적으로 확장됩니다.

    **실제로 중요한 것은 `timeout`입니다**: 이미지 생성(특히 4K이거나 피크 혼잡 시)은 요청당 시간이 꽤 걸릴 수 있으므로, 아직 정상적으로 처리 중인 요청이 끊기지 않도록 **클라이언트 timeout을 360초로 설정하십시오**.

    <Tip>
      가끔 429(높은 동시 실행 수로 인해 throttled됨)가 발생하면 token의 대체 그룹으로 `NanoBananaEnterprise`를 추가하십시오(위의 '그룹 설정' 참고). 주 그룹이 포화되면 자동으로 폴백하여 높은 동시 실행 수에서도 성공률이 더 높아집니다.
    </Tip>
  </Accordion>

  <Accordion title="어떤 입력 이미지 형식이 지원됩니까?">
    `image/png` 및 `image/jpeg` 형식을 지원합니다. base64 인코딩 또는 Files API를 통해 업로드할 수 있습니다.
  </Accordion>

  <Accordion title="출력 이미지에 워터마크가 있습니까?">
    모든 출력 이미지는 SynthID 보이지 않는 디지털 워터마크(Google의 AI 생성 콘텐츠 식별 기술)를 포함합니다. 육안으로는 보이지 않으며 사용에 영향을 주지 않습니다.
  </Accordion>

  <Accordion title="connection reset by peer / write_response_body_failed (500) 오류가 나는 이유는 무엇입니까?">
    전체 오류는 다음과 같습니다:

    ```text theme={null}
    [&{{write tcp ip:port->ip:port: write: connection reset by peer Unknown error shell_api_error  write_response_body_failed} 500 }]
    ```

    이는 **대개 이미지 업로드가 너무 커서 발생합니다. 요청 본문이 지나치게 커지면서 연결이 끊어지는 것입니다**. 다음 모범 사례를 따르십시오:

    * **이미지 개수를 제한하십시오**: 공식 규칙(한 prompt당 최대 14장) 내에서 유지하십시오. 참조 이미지를 지나치게 많이 넣지 마십시오.
    * **이미지당 크기를 제한하십시오**: 각 이미지를 5MB 이하로 유지하십시오. 공식 이미지당 상한은 7MB이며, base64 인코딩은 크기를 대략 1/3 정도 늘리므로 여유를 남겨 두십시오.
    * **업로드 전에 프런트엔드에서 압축하십시오**: API로 보내기 전에 프런트엔드(또는 서버 측 릴레이)에서 이미지를 압축하십시오. 일반적으로 가장 긴 변을 제한하고, JPEG/WebP로 변환하며, quality 매개변수를 조정합니다.
    * **URL 입력으로 전환하십시오**: Gemini 네이티브 형식은 `fileData.fileUri`를 통해 이미지 URL 전달을 지원하므로, 지나치게 큰 base64 요청 본문 문제를 완전히 피할 수 있습니다. [Nano Banana 개발 가이드](/ko/api-capabilities/nano-banana-dev-guide)를 참고하십시오.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [Nano Banana Pro 이미지 생성](/en/api-capabilities/nano-banana-image) - 이전 플래그십 버전
* [Nano Banana 이미지 편집](/en/api-capabilities/nano-banana-image-edit) - 이미지 편집 기능
* [이미지 생성 비교 테스트](https://imagen.apiyi.com/)
* [API 사용 설명서](/ko/api-manual)

<Info>
  Nano Banana 2는 현재 Preview 상태입니다. 기능과 가격은 조정될 수 있습니다. 최신 정보를 위해 문서 업데이트를 확인하십시오.
</Info>