---
title: nano-banana-2.1 API — Nano Banana 요금 및 스펙 | RunAPI
description: RunAPI에서 nano-banana-2.1를 사용하세요 — Nano Banana 패밀리. 호출당 요금, 모델 ID, 스펙, 개발자 설정 가이드를 제공합니다.
url: https://runapi.ai/ko/models/nano-banana/2.1.md
canonical: https://runapi.ai/ko/models/nano-banana/2.1
locale: ko
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/models/nano-banana/2.1
  zh-CN: https://runapi.ai/zh-CN/models/nano-banana/2.1
  es: https://runapi.ai/es/models/nano-banana/2.1
  ja: https://runapi.ai/ja/models/nano-banana/2.1
  de: https://runapi.ai/de/models/nano-banana/2.1
  fr: https://runapi.ai/fr/models/nano-banana/2.1
  pt-BR: https://runapi.ai/pt-BR/models/nano-banana/2.1
  ko: https://runapi.ai/ko/models/nano-banana/2.1
  it: https://runapi.ai/it/models/nano-banana/2.1
  nl: https://runapi.ai/nl/models/nano-banana/2.1
  pl: https://runapi.ai/pl/models/nano-banana/2.1
  tr: https://runapi.ai/tr/models/nano-banana/2.1
  zh-TW: https://runapi.ai/zh-TW/models/nano-banana/2.1
  zh-HK: https://runapi.ai/zh-HK/models/nano-banana/2.1
  ar: https://runapi.ai/ar/models/nano-banana/2.1
  x-default: https://runapi.ai/models/nano-banana/2.1
model: Nano Banana
provider: Google
variant_id: nano-banana-2.1
sdk_model_id: nano-banana-2.1
modality: image
billing_unit: 회
status: maintenance
---

> HTML version: https://runapi.ai/ko/models/nano-banana/2.1
> Site index for agents: https://runapi.ai/llms.txt


# nano-banana-2.1  API

**점검 중:** 이 모델은 점검 중이라 API 호출이 일시 중지되었습니다. 나중에 다시 시도하세요.

RunAPI로 Nano Banana 패밀리의 nano-banana-2.1를 사용하세요. 호출당 요금, 구독 없음, 실패한 생성은 과금되지 않습니다.

**Google / [Nano Banana](https://runapi.ai/ko/models/nano-banana.md)**
**점검 중 · image · 상업적 사용 지원**




### 변형 전환

- [nano-banana](https://runapi.ai/ko/models/nano-banana/nano-banana.md)
- [nano-banana-2](https://runapi.ai/ko/models/nano-banana/2.md)
- [nano-banana-2-lite](https://runapi.ai/ko/models/nano-banana/2-lite.md)
- **nano-banana-2.1** (current)
- [nano-banana-edit](https://runapi.ai/ko/models/nano-banana/edit.md)
- [nano-banana-pro](https://runapi.ai/ko/models/nano-banana/pro.md)

사용 가능한 버전 6개





Nano Banana nano-banana-2.1는 같은 RunAPI 인증, model skill 워크플로, 사용량 기반 가격으로 사용할 수 있습니다.

- 통합 API key
- Model skill 설정
- 모델 ID 참조
- 실패한 생성은 과금되지 않습니다
- model ID 매개변수 하나를 바꾸어 variant 전환
- 모든 모델과 제공사의 청구 통합




## 스펙

| 필드 | 값 |
|---|---|
| 제공자 | Google |
| 모델 ID | nano-banana-2.1 |
| 모달리티 | 이미지 |
| 작업 유형 | Asynchronous |
| API 엔드포인트 | [/api/v1/nano_banana/text_to_image](https://runapi.ai/ko/docs/api/nano-banana/text-to-image) |
| 청구 단위 | 회 |
| 입력 매개변수 | aspect_ratio, callback_url, model, output_format, output_resolution, prompt, reference_image_urls |
| 최대 해상도 | 1k, 2k, 4k |
| 종횡비 | 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto |
| 출력 형식 | png, jpg |
| 카탈로그 상태 | 점검 중 |



**사용 방법**

## 이 모델을 3단계로 사용하기

1. **키 받기** - 무료로 가입하고 대시보드에서 nano-banana-2.1용 API 키를 만드세요.
2. **요청 보내기** - /api/v1/nano_banana/text_to_image로 nano-banana-2.1 모델 ID와 매개변수를 포함한 POST 요청을 보내세요.
3. **결과 받기** - 작업을 폴링하거나 콜백을 따라 완료된 nano-banana-2.1 결과를 가져오세요.



<!-- catalog-model-detail-slot: feature-cards -->

## 이 모델이 제공하는 것

- **출력 해상도** — 공개된 endpoint 스키마의 1k, 2k, 4k를 지원합니다.
- **유연한 파라미터** — aspect_ratio, output_format, output_resolution, prompt, reference_image_urls 포함 5개 문서화된 파라미터를 설정할 수 있습니다.
- **endpoint 구성** — 1개의 공개 endpoint를 제공합니다: text_to_image.
- **webhook 전달** — 비동기 태스크는 완료 알림을 위한 콜백 URL을 수락합니다.
<!-- /catalog-model-detail-slot: feature-cards -->



## Nano Banana 2.1 요금

| 엔드포인트 | 해상도 | 기간 | 가격 |
|---|---|---|---|
| `text_to_image` | 사용할 수 없음 | 회 | 가격 준비 중 |



**API 레퍼런스**

## 엔드포인트 사양

| Field | Value |
|---|---|
| 엔드포인트 | `POST /api/v1/nano_banana/text_to_image` |
| 모델 ID | `nano-banana-2.1` |
| 작업 유형 | `text_to_image` |
| 최대 시간 | `사용할 수 없음` |
| 해상도 | `1k, 2k, 4k` |
| 화면 비율 | `1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto` |
| 출력 형식 | `PNG, JPG` |
| 평균 생성 시간 | `사용할 수 없음` |


<!-- catalog-model-detail-slot: request-parameters -->

## 요청 매개변수

### `prompt`

**필수** · `string`

Image description or editing instructions.

### `aspect_ratio`

**선택 사항** · `string`

Output aspect ratio. (1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto)

### `callback_url`

**선택 사항** · `string`

Webhook URL for async notifications.

### `output_format`

**선택 사항** · `string`

Output image format. (png, jpg)

### `output_resolution`

**선택 사항** · `string`

Output image resolution. (1k, 2k, 4k)

### `reference_image_urls`

**선택 사항** · `array`

Up to ten reference image URLs for generation or editing.

<!-- /catalog-model-detail-slot: request-parameters -->

**Request example**

```json
{
  "model": "nano-banana-2.1",
  "prompt": "볼드 세리프 폰트로 'Never Give Up' 텍스트와 배경에 석양빛 산이 있는 동기부여 포스터를 만들어 주세요."
}
```

### 모델 스킬 — nano-banana-2.1

스킬을 한 번 설치한 후, 이 페이지의 변형 ID를 사용해 개발을 시작하세요.

```sh
npx skills add runapi-ai/nano-banana -g
```

```text
Install the Nano Banana skill for this app:

1. Add runapi-ai/nano-banana with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps with model ID nano-banana-2.1.
4. Confirm the install path when done.
```

### nano-banana-2.1 사용 방법

1. **모델 선택** — 앱 워크플로에 맞는 모델과 변형을 고릅니다.
2. **모델 ID 전달** — 요청 본문에 이 변형 ID를 사용합니다.
3. **작업 실행** — 요청을 보내고 반환된 task ID를 저장합니다.
4. **출력 수집** — 작업이 끝나면 조회하거나 callback으로 결과를 받습니다.

### nano-banana-2.1 비교

- **VS NANO-BANANA: nano-banana-2.1** — 1K 해상도; 빠른 기본 버전 (2025년 8월)
- **VS NANO-BANANA-2: nano-banana-2.1** — Gemini 3.1 Flash 기반; 최고의 다중 캐릭터 일관성, 4–8초
- **VS NANO-BANANA-2-LITE: nano-banana-2.1** — 빠른 생성과 반복에 적합한 가장 빠르고 저렴한 Nano Banana 이미지 모델

## 사용 사례

**이미지 생성**

텍스트 prompt에서 시각 asset을 만듭니다.

**편집**

prompt 지시에 따라 기존 이미지를 변환합니다.

**배치 제작**

SDK로 반복 가능한 생성을 구현합니다.



## Nano Banana 2.1 자주 묻는 질문

### nano-banana-2.1는 어떻게 선택하나요?

quickstart에 표시된 모델 ID를 전달하세요.

### 가격은 사용량 기반인가요?

네. 호출 또는 단위 기준으로 측정됩니다.

### 나중에 variant를 바꿀 수 있나요?

네. variant는 요청 매개변수입니다. model ID만 변경하면 되며 코드 변경, 재인증, 별도 청구 설정이 필요하지 않습니다. 모든 variant는 같은 API key와 요청 형식을 공유합니다.

### streaming을 지원하나요?

streaming이 가능한 경우 RunAPI는 엔드투엔드로 전송합니다. LLM 모델은 token 단위 streaming을 지원하며 미디어 모델은 비동기 작업 polling 또는 webhook callback으로 결과를 전달합니다.

### 품질 문제는 어디에 보고하나요?

공개 GitHub repo에 issue를 열거나 contact@runapi.ai로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요.

### 별도 제공사 계정이 필요한가요?

아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다.


### 관련

- [nano-banana-2-lite](https://runapi.ai/ko/models/nano-banana/2-lite.md) — Google 제공 · $0.03 / 회
- [nano-banana](https://runapi.ai/ko/models/nano-banana/nano-banana.md) — Google 제공 · $0.03 / 회
- [nano-banana-edit](https://runapi.ai/ko/models/nano-banana/edit.md) — Google 제공 · $0.03 / 회
- [nano-banana-2](https://runapi.ai/ko/models/nano-banana/2.md) — Google 제공 · $0.05 / 회

### 오늘 Nano Banana로 시작하세요.

- [무료 계정 만들기](https://runapi.ai/ko/login)
- [빠른 시작 읽기 →](https://runapi.ai/ko/docs/api/nano-banana/text-to-image)
## 팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

[문의하기](https://runapi.ai/ko/contact.md)



---

## More from RunAPI

- [Home](https://runapi.ai/ko/.md)
### 제품
- [모델 카탈로그](https://runapi.ai/ko/models.md)
- [요금](https://runapi.ai/ko/pricing.md)
- [제공사](https://runapi.ai/ko/models#all-models)
### 개발자
- [문서](https://runapi.ai/ko/docs/guides)
- [SDK](https://runapi.ai/ko/sdk.md)
- [CLI](https://runapi.ai/ko/cli.md)
- [MCP Server](https://runapi.ai/ko/mcp.md)
- [x402](https://runapi.ai/ko/x402.md)
### 가이드
- [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md)
- [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md)
- [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md)
### 회사
- [엔터프라이즈](https://runapi.ai/ko/contact.md)
- [문의](https://runapi.ai/ko/contact.md)
### 법적 고지
- [약관](https://runapi.ai/ko/terms.md)
- [개인정보](https://runapi.ai/ko/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/koicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "SoftwareApplication",
    "name": "Nano Banana nano-banana-2.1",
    "applicationCategory": "DeveloperApplication"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://runapi.ai/ko"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Models",
        "item": "https://runapi.ai/ko/models"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Nano Banana",
        "item": "https://runapi.ai/ko/models/nano-banana"
      },
      {
        "@type": "ListItem",
        "position": 4,
        "name": "nano-banana-2.1",
        "item": "https://runapi.ai/ko/models/nano-banana/2.1"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "HowTo",
    "name": "nano-banana-2.1 사용 방법",
    "description": "RunAPI에서 nano-banana-2.1를 사용하세요 — Nano Banana 패밀리. 호출당 요금, 모델 ID, 스펙, 개발자 설정 가이드를 제공합니다.",
    "totalTime": "PT5M",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "모델 선택",
        "text": "앱 워크플로에 맞는 모델과 변형을 고릅니다.",
        "url": "https://runapi.ai/ko/models/nano-banana/2.1#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "모델 ID 전달",
        "text": "요청 본문에 이 변형 ID를 사용합니다.",
        "url": "https://runapi.ai/ko/models/nano-banana/2.1#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "작업 실행",
        "text": "요청을 보내고 반환된 task ID를 저장합니다.",
        "url": "https://runapi.ai/ko/models/nano-banana/2.1#how-step-3"
      },
      {
        "@type": "HowToStep",
        "position": 4,
        "name": "출력 수집",
        "text": "작업이 끝나면 조회하거나 callback으로 결과를 받습니다.",
        "url": "https://runapi.ai/ko/models/nano-banana/2.1#how-step-4"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "nano-banana-2.1는 어떻게 선택하나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "quickstart에 표시된 모델 ID를 전달하세요."
        }
      },
      {
        "@type": "Question",
        "name": "가격은 사용량 기반인가요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "네. 호출 또는 단위 기준으로 측정됩니다."
        }
      },
      {
        "@type": "Question",
        "name": "나중에 variant를 바꿀 수 있나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "네. variant는 요청 매개변수입니다. model ID만 변경하면 되며 코드 변경, 재인증, 별도 청구 설정이 필요하지 않습니다. 모든 variant는 같은 API key와 요청 형식을 공유합니다."
        }
      },
      {
        "@type": "Question",
        "name": "streaming을 지원하나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "streaming이 가능한 경우 RunAPI는 엔드투엔드로 전송합니다. LLM 모델은 token 단위 streaming을 지원하며 미디어 모델은 비동기 작업 polling 또는 webhook callback으로 결과를 전달합니다."
        }
      },
      {
        "@type": "Question",
        "name": "품질 문제는 어디에 보고하나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "공개 GitHub repo에 issue를 열거나 contact@runapi.ai로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요."
        }
      },
      {
        "@type": "Question",
        "name": "별도 제공사 계정이 필요한가요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다."
        }
      }
    ]
  }
]
```
