# Gemini(제미나이) 이미지 API 사용법: 키 발급부터 코드까지, 무료 티어 없음

> Gemini 이미지 API는 2026년 10월 기준 Nano Banana 2 Lite·2·Pro 3종입니다. 키는 무료지만 이미지 출력은 $5 선불 후 표준 장당 $0.0336~$0.24입니다.

- URL: https://blog.laozhang.ai/ko/posts/gemini-image-api-guide-2026
- Published: 2026-03-16
- Updated: 2026-10-05
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ko/about)
- Topic: API 가이드
- Tags: Gemini API, 제미나이 이미지 API, Nano Banana 2, Nano Banana Pro, google-genai, Interactions API

---
2026년 10월 5일 기준으로 Gemini API에서 이미지를 생성·편집할 수 있는 모델은 Nano Banana 2 Lite(`gemini-3.1-flash-lite-image`), Nano Banana 2(`gemini-3.1-flash-image`), Nano Banana Pro(`gemini-3-pro-image`) 세 가지입니다. API 키 발급은 무료지만 세 모델 모두 이미지 출력에 무료 티어가 없습니다. 그래서 첫 이미지를 받으려면 프로젝트에 결제를 연결하고 최소 $5를 선불 충전해야 합니다.

코드는 `google-genai` SDK로 작성합니다. Google 이미지 생성 가이드는 예제를 Interactions API(`client.interactions.create`)로 싣고 있고, 기존 generateContent 엔드포인트도 레퍼런스에 그대로 남아 있습니다. 처음이라면 Nano Banana 2의 1K(Standard 장당 $0.067)로 시작하고, 1K 단발 생성을 대량으로 돌릴 때는 Lite, 글자가 많은 복잡한 이미지나 정밀한 편집에는 Pro를 고르는 순서가 무난합니다.

아래 코드 예제는 Google 이미지 생성 가이드(2026년 9월 23일 갱신)와 generateContent API 레퍼런스의 요청 형식을 옮긴 것이며, 실제 API 호출로 실행한 결과는 아닙니다. 이미지를 입력해 설명·분류 같은 텍스트 답을 받는 기능은 Google 문서에서 '이미지 이해'로 따로 다루며, 이미지 생성 모델과는 별개입니다.

## Gemini 이미지 API 현행 모델 3종과 종료된 모델 ID

새로 작성하는 코드에는 아래 세 ID만 쓰면 됩니다. 가격은 [Gemini API 가격 페이지](https://ai.google.dev/gemini-api/docs/pricing) 2026년 10월 4일 기준 Standard 요금이고, 참조 이미지 한도는 [이미지 생성 가이드](https://ai.google.dev/gemini-api/docs/image-generation)의 표를 따랐습니다.

| 모델 | 모델 ID | Standard 1장 가격 | 출력 크기 | 참조 이미지 | 맞는 작업 |
|---|---|---|---|---|---|
| Nano Banana 2 Lite | `gemini-3.1-flash-lite-image` | $0.0336 (1K) | 1K만 | 사물 최대 14장 | 속도와 비용이 우선인 대량 단발 생성 |
| Nano Banana 2 | `gemini-3.1-flash-image` | $0.045 (0.5K) ~ $0.151 (4K) | 0.5K·1K·2K·4K | 사물 10장 + 인물 4장 | 범용 기본값, 4K, 여러 참조 이미지 |
| Nano Banana Pro | `gemini-3-pro-image` | $0.134 (1K·2K), $0.24 (4K) | 1K·2K·4K | 사물 6장 + 인물 5장 + 스타일 3장 | 복잡한 레이아웃, 글자 렌더링, 브랜드 일관성 |

Google 가이드는 Lite를 "가장 빠르고 저렴한 모델"로 소개하면서 여러 참조 이미지 입력이나 여러 턴에 걸친 연속 편집에는 최적화되지 않았다고 적고 있습니다. Google 검색으로 사실을 확인하며 이미지를 만드는 기능(Grounding with Google Search)도 Lite에서는 지원하지 않습니다. Pro는 사고(Thinking) 과정이 기본으로 켜져 있고 이 사고 토큰도 과금됩니다. 다만 추론 중에 만드는 중간 '사고 이미지'는 과금되지 않습니다.

[Google 지원 중단 일정](https://ai.google.dev/gemini-api/docs/deprecations)상 이미 종료된 ID는 다음과 같습니다. 예전 튜토리얼 코드를 복사했다면 이 ID부터 바꿔야 호출이 됩니다.

- `gemini-3-pro-image-preview`, `gemini-3.1-flash-image-preview`: 2026년 6월 25일 종료. 각각 `gemini-3-pro-image`, `gemini-3.1-flash-image`로 바꿉니다.
- `gemini-2.5-flash-image`(1세대 Nano Banana, 장당 $0.039): 2026년 10월 2일 종료. Google 가이드는 Nano Banana 2 Lite로 옮기라고 권합니다.
- `imagen-4.0-generate-001`, `imagen-4.0-ultra-generate-001`, `imagen-4.0-fast-generate-001`: 2026년 8월 17일 종료. 권장 대체 모델은 `gemini-3.1-flash-image`입니다.

![Nano Banana 2 Lite, Nano Banana 2와 Nano Banana Pro의 현행 API ID와 적합한 작업](https://blog.laozhang.ai/posts/ko/gemini-image-api-guide-2026/img/models-comparison.webp)



## API 키 발급과 결제 연결: 이미지 생성은 $5 선불부터

키를 만드는 데는 돈이 들지 않지만, 이미지 모델을 부르려면 유료 티어가 필요합니다. 가격 페이지의 무료 티어 칸에는 세 이미지 모델 모두 입력·출력이 "Not available"로 적혀 있습니다. Google AI Studio는 만 18세 이상만 쓸 수 있고, 대한민국은 [Gemini API 이용 가능 지역](https://ai.google.dev/gemini-api/docs/available-regions) 목록에 들어 있습니다.

1. [Google AI Studio](https://aistudio.google.com/)에 Google 계정으로 로그인합니다. 신규 사용자에게는 기본 프로젝트와 API 키가 자동으로 만들어지고, 키를 더 만들려면 API 키 페이지에서 Create API key를 누릅니다.
2. API 키 페이지나 Projects 페이지에서 해당 프로젝트의 Billing Tier 열에 있는 Set up billing을 누릅니다. 국가를 고르고 연락처와 결제 수단을 입력합니다.
3. 최소 $5를 선불(Prepay) 충전하면 설정이 끝납니다. 계정에 따라 Prepay와 Postpay 중에서 고르라는 화면이 나올 수도 있습니다. 결제를 연결하면 Free에서 Tier 1로의 승급은 보통 바로 반영됩니다.
4. 키는 코드에 직접 쓰지 말고 환경 변수에 넣습니다.

```bash
pip install google-genai
export GEMINI_API_KEY="AI Studio에서 발급한 키"
```

[결제 문서](https://ai.google.dev/gemini-api/docs/billing)에서 알아 둘 조건은 다음과 같습니다.

- 선불 잔액이 $0이 되면 그 결제 계정에 연결된 모든 프로젝트의 키가 한꺼번에 멈추고, 충전할 때까지 요청이 HTTP 402 Payment Required로 실패합니다. 자동 충전(auto-reload)을 걸어 둘 수 있습니다.
- 구매한 크레딧은 12개월 뒤 만료되고 환불되지 않습니다(Postpay로 전환할 때는 예외).
- Google Cloud의 $300 Welcome credit은 Gemini API와 AI Studio 사용료에 쓸 수 없습니다. 2026년 3월 2일 이후 개설한 계정이 여기에 해당합니다.
- 400·500 오류로 실패한 요청은 토큰 요금이 나가지 않지만 할당량에는 포함됩니다.
- 유료 티어에서 보낸 프롬프트와 응답은 Google 제품 개선에 쓰이지 않습니다.

AI Studio 화면(Playground)에서 이미지 모델을 눌러 보는 것도 무료가 아닙니다. 2026년 10월 5일 기준으로 API 키도 Google AI 요금제도 없는 개인 계정에서 `gemini-3.1-flash-image`를 고르면 "Nano Banana 2는 Google AI 요금제나 API 키로만 쓸 수 있다"는 업그레이드 안내가 뜹니다.

## google-genai SDK로 첫 이미지 생성: Interactions API 예제

Google 가이드의 현재 예제는 모두 Interactions API 형식입니다. `genai.Client()`는 환경 변수 `GEMINI_API_KEY`를 읽고, 생성된 이미지는 `interaction.output_image.data`에 base64로 들어옵니다.

```python
import base64
from google import genai

client = genai.Client()  # 환경 변수 GEMINI_API_KEY 사용

interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="흰 대리석 위에 놓인 미니멀한 세라믹 머그잔 제품 사진, 왼쪽에서 들어오는 부드러운 자연광",
    response_format={
        "type": "image",
        "aspect_ratio": "16:9",
        "image_size": "2K",
    },
)

with open("mug.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))
```

`response_format`을 빼면 기본 크기 1K로 나오고, 비율은 입력 이미지가 있으면 그 비율을, 없으면 1:1을 따릅니다. 같은 요청을 REST로 보낼 때는 `https://generativelanguage.googleapis.com/v1beta/interactions`에 `x-goog-api-key` 헤더를 붙여 POST합니다. 텍스트와 이미지가 번갈아 나오는 응답에서는 `output_image`가 마지막 이미지 하나만 돌려주므로, 그런 경우에는 가이드 설명대로 응답 단계를 직접 순회해야 합니다.

### 이미지 편집: 원본 이미지와 지시문을 함께 보내기

편집은 `input`을 리스트로 만들어 지시문과 원본 이미지를 함께 넣습니다. Google은 바꿀 부분만 정확히 짚고 "나머지는 그대로 유지"하라고 적는 방식을 권합니다.

```python
import base64
from google import genai

client = genai.Client()

with open("product.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode("utf-8")

edit = client.interactions.create(
    model="gemini-3.1-flash-image",
    input=[
        {"type": "text", "text": "제공한 이미지에서 배경만 밝은 회색 스튜디오 배경으로 바꿔 주세요. 제품, 조명, 구도는 그대로 유지하세요."},
        {"type": "image", "data": image_b64, "mime_type": "image/png"},
    ],
)

with open("product_gray.png", "wb") as f:
    f.write(base64.b64decode(edit.output_image.data))

# 이어서 수정할 때는 이전 결과의 id를 넘깁니다
next_edit = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="같은 구도에서 배경 색만 짙은 남색으로 바꿔 주세요.",
    previous_interaction_id=edit.id,
)
```

업로드하는 이미지에 대한 권리는 직접 갖추고 있어야 하며, 다른 사람을 속이거나 괴롭히거나 해치는 이미지는 Google의 금지 사용 정책 위반입니다. 이 점은 Google 가이드의 편집 예제 위에도 명시돼 있습니다.

## generateContent로 호출할 때: imageConfig로 비율과 크기 지정

기존 코드가 generateContent 기반이거나 안전 설정(`safetySettings`)을 직접 조정해야 한다면 이 엔드포인트를 씁니다. 안전 설정은 Interactions API에서 지원되지 않습니다. 비율과 크기는 `generationConfig.imageConfig`의 `aspectRatio`, `imageSize`로 지정합니다.

```bash
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "가을 북페어 포스터, 상단에 큰 제목 \"서울 북페어 2026\", 따뜻한 일러스트 스타일"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "3:4", "imageSize": "2K"}
    }
  }' > response.json

# 사고 과정(thought) 이미지를 빼고 마지막 이미지 저장
jq -r '[.candidates[0].content.parts[] | select(.inlineData and (.thought | not))] | last | .inlineData.data' response.json \
  | base64 --decode > poster.png

# 이미지가 없으면 종료 사유부터 확인
jq '{finishReason: .candidates[0].finishReason, blockReason: .promptFeedback.blockReason}' response.json
```

응답 이미지는 `candidates[0].content.parts[]` 안의 `inlineData.data`에 base64로 들어 있습니다. Pro는 추론 중 사고 이미지를 만들 수 있으므로 `thought`가 표시된 부분은 건너뛰고 최종 이미지를 고릅니다. `responseModalities`에 요청한 조합을 모델이 지원하지 않으면 오류가 납니다.

## 크기와 비율: 기본 1K, 크기 값은 대문자 K

크기를 지정하지 않으면 1K로 나옵니다. 크기 값은 반드시 대문자 K(`1K`, `2K`, `4K`)로 써야 하며, 소문자 `1k`는 거부됩니다. generateContent 레퍼런스가 허용하는 `imageSize` 값은 `512`, `1K`, `2K`, `4K`이고, 512px(0.5K)는 Nano Banana 2에서만 됩니다.

| 모델 | 크기 | 비율 | 16:9 픽셀 예시 |
|---|---|---|---|
| Nano Banana 2 Lite | 1K만 | 10종 | 1K만 지원 |
| Nano Banana 2 | 0.5K·1K·2K·4K | 14종(1:4, 4:1, 1:8, 8:1 포함) | 1K 1376x768, 2K 2752x1536, 4K 5504x3072 |
| Nano Banana Pro | 1K·2K·4K | 10종 | 1K 1376x768, 2K 2752x1536, 4K 5504x3072 |

공통 10종은 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9입니다. 1:1 4K는 두 모델 모두 4096x4096이지만, 다른 비율의 4K는 4096x4096이 아닙니다. 예를 들어 Pro의 9:16 4K는 3072x5504, 21:9 4K는 6336x2688입니다.

크기에 따라 출력 토큰이 달라지고 그만큼 가격이 바뀝니다. Pro는 1K와 2K가 똑같이 1,120토큰이라 가격이 같고(장당 $0.134), 4K는 2,000토큰($0.24)입니다. Nano Banana 2는 0.5K 747토큰, 1K 1,120토큰, 2K 1,680토큰, 4K 2,520토큰으로 크기마다 가격이 올라갑니다. Pro는 1K로 낮춰도 요금이 줄지 않으므로, 파일 크기를 줄여야 하는 경우가 아니면 2K를 기본으로 두는 편이 낫습니다.

## 참조 이미지는 최대 14장, 모델마다 구성이 다름

Gemini 3 계열 이미지 모델은 한 요청에 참조 이미지를 최대 14장까지 섞을 수 있지만, 사물·인물·스타일로 나눈 내역은 모델마다 다릅니다.

| 모델 | 사물(고충실도) | 인물(캐릭터 일관성) | 스타일 참조 |
|---|---|---|---|
| Nano Banana 2 Lite | 최대 14장 | 지원 안 함 | 지원 안 함 |
| Nano Banana 2 | 최대 10장 | 최대 4장 | 지원 안 함 |
| Nano Banana Pro | 최대 6장 | 최대 5장 | 최대 3장 |

Google의 Nano Banana 2 출시 글에는 "인물 최대 5명, 사물 14개"라고 돼 있어 API 가이드 표와 숫자가 다릅니다. 코드를 짤 때는 API 가이드 표를 기준으로 삼는 편이 안전합니다. 입력 이미지는 입력 토큰으로 과금되는데, Pro 기준 참조 이미지 1장은 560토큰으로 약 $0.0011입니다.

## Gemini 이미지 API 장당 가격: Standard와 Batch

아래는 [가격 페이지](https://ai.google.dev/gemini-api/docs/pricing) 2026년 10월 4일 기준의 이미지 1장당 출력 요금입니다. 텍스트·사고 토큰과 입력 토큰은 별도입니다.

| 모델 | 크기 | Standard | Batch |
|---|---|---|---|
| Nano Banana 2 Lite | 1K | $0.0336 | $0.0168 |
| Nano Banana 2 | 0.5K | $0.045 | $0.022 |
| Nano Banana 2 | 1K | $0.067 | $0.034 |
| Nano Banana 2 | 2K | $0.101 | $0.050 |
| Nano Banana 2 | 4K | $0.151 | $0.076 |
| Nano Banana Pro | 1K·2K | $0.134 | $0.067 |
| Nano Banana Pro | 4K | $0.24 | $0.12 |

Batch API는 Standard의 50% 가격으로 비동기 처리하며, 목표 처리 시간은 24시간입니다. 결과를 바로 보여 줘야 하는 서비스가 아니라 상품 이미지 일괄 생성처럼 기다릴 수 있는 작업이라면 Batch가 가장 큰 절감 수단입니다. Pro를 Batch로 돌리는 계산은 [Nano Banana Pro Batch API 비용 계산](https://blog.laozhang.ai/ko/posts/nano-banana-pro-batch-api-cost-optimization)에 정리돼 있습니다.

최소 선불액 $5로 만들 수 있는 장수를 Standard 이미지 출력 요금만으로 계산하면 다음과 같습니다(소수점 아래는 버림, 입력·텍스트 토큰 제외).

- Nano Banana 2 Lite 1K: 5 ÷ 0.0336 = 148장
- Nano Banana 2 1K: 5 ÷ 0.067 = 74장
- Nano Banana Pro 1K·2K: 5 ÷ 0.134 = 37장
- Nano Banana Pro 4K: 5 ÷ 0.24 = 20장

Google 검색 그라운딩을 켜면 Gemini 3.x 모델 전체에서 월 5,000건까지 무료이고 그 뒤로는 1,000건당 $14가 붙습니다. 해상도별·모델별 상세 비교는 [Nano Banana 2 API 요금 계산](https://blog.laozhang.ai/ko/posts/nano-banana-2-api-pricing-guide)과 [Nano Banana API 가격: Lite, Nano Banana 2, Pro 비교](https://blog.laozhang.ai/ko/posts/nano-banana-api-pricing-free-vs-pro)에서 이어서 볼 수 있습니다.

Google 결제 대신 호출당 정액이 편하거나 Pro 4K 비중이 큰 경우에는 LaoZhang API 같은 게이트웨이도 유료 선택지가 됩니다. [LaoZhang API 문서](https://docs.laozhang.ai/en/api-capabilities/nano-banana-image)의 2026년 9월 24일 공개 가격은 `gemini-3-pro-image`가 1K·2K·4K 모두 호출당 $0.09, `gemini-3.1-flash-image`가 호출당 $0.055입니다. Pro 4K는 Google Standard $0.24보다 (0.24 − 0.09) ÷ 0.24 = 62.5% 낮지만, Pro 1K·2K는 Google Batch $0.067이 더 쌉니다. 이미지 없이 HTTP 200이 돌아와도 1회로 과금되고, 크기와 비율은 Gemini 네이티브 경로에서만 지정됩니다(OpenAI 호환 경로는 1:1, 1K 고정). 요청은 Google 모델로 전달되므로 Google의 안전 정책도 그대로 적용됩니다.

*안내: [laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다](https://blog.laozhang.ai/ko/about#laozhang). 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.*

![현행 Gemini 이미지 모델의 1K 이미지 1장 Standard·Batch 출력 가격과 별도 비용](https://blog.laozhang.ai/posts/ko/gemini-image-api-guide-2026/img/pricing-comparison.webp)



## 요청 한도(rate limit): 프로젝트 단위, 이미지는 IPM으로 계산

[요청 한도 문서](https://ai.google.dev/gemini-api/docs/rate-limits)에 따르면 한도는 API 키가 아니라 프로젝트 단위로 걸립니다. 같은 프로젝트에서 키를 여러 개 만들어도 한도는 늘지 않습니다. 하루 요청 수(RPD)는 태평양 시간 자정에 초기화되고, 이미지 모델에는 분당 요청 수 외에 분당 이미지 수(IPM)도 적용됩니다. 현행 이미지 모델의 구체적인 숫자는 문서에 표로 나와 있지 않으니 AI Studio의 한도 화면에서 프로젝트별로 확인해야 합니다.

| 등급 | 조건 | 10분당 지출 한도 |
|---|---|---|
| Tier 1 | 활성 결제 계정 연결 | $10 |
| Tier 2 | 누적 $100 결제 + 첫 결제 후 3일 | $50 |
| Tier 3 | 누적 $1,000 결제 + 첫 결제 후 30일 | $200 |

지출 기반 한도는 결제 이력과 계정 상태에 따라 적용 여부가 달라집니다. 적용된다면 Tier 1에서 Pro 4K는 10분에 10 ÷ 0.24 = 41장 정도가 상한이 되는 셈입니다. 등급은 조건을 채우면 자동으로 올라가며, Tier 1 이후 승급은 10분 안에 반영됩니다. Batch 요청은 일반 호출과 별도의 한도를 씁니다.

## 자주 나는 오류: 402, 429와 이미지 없는 응답의 finishReason

HTTP 상태 코드는 결제·한도 문제를, `finishReason`과 `promptFeedback.blockReason`은 내용 문제를 알려 줍니다.

| 증상 | 의미 | 할 일 |
|---|---|---|
| HTTP 402 Payment Required | 선불 잔액 $0 | 크레딧 충전 또는 자동 충전 설정 |
| HTTP 429 `RESOURCE_EXHAUSTED` | RPM·IPM·RPD 또는 10분 지출 한도 초과 | 지수 백오프로 재시도, 동시 요청 줄이기, 급하지 않은 작업은 Batch로 이동 |
| 종료된 모델 ID로 호출 실패 | `-preview` ID, `gemini-2.5-flash-image`, Imagen 4 | 현행 ID로 교체 |
| `finishReason`: `IMAGE_SAFETY`, `IMAGE_PROHIBITED_CONTENT` | 생성 이미지가 안전 정책이나 금지 콘텐츠에 걸림 | 프롬프트와 참조 이미지 내용 수정 |
| `finishReason`: `SPII` | 민감한 개인 식별 정보가 포함될 가능성 | 개인정보가 들어간 요소 제거 |
| `finishReason`: `IMAGE_OTHER`, `NO_IMAGE`, `OTHER` / `blockReason`: `OTHER` | 기타 사유, 원인 미공개 | 프롬프트를 단순화하고 참조 이미지를 줄여 재현 범위 좁히기 |

현행 Gemini 모델은 조정 가능한 안전 필터가 기본적으로 꺼져(Off) 있고, 아동 안전 같은 핵심 보호는 설정과 관계없이 항상 차단됩니다. 그래서 `safetySettings`를 `BLOCK_NONE`이나 `OFF`로 바꿔도 `IMAGE_SAFETY`나 `PROHIBITED_CONTENT` 결과가 풀릴 것으로 기대하기는 어렵습니다. 문서의 기본값에서 추론한 결론이며, 실제로 풀리는 범위는 [Nano Banana Pro 안전 필터 설정과 차단 원인](https://blog.laozhang.ai/ko/posts/nano-banana-pro-safety-filters)에서, 원인이 공개되지 않는 `OTHER` 대응은 [Nano Banana 2 blockReason OTHER 확인 순서](https://blog.laozhang.ai/ko/posts/nano-banana-2-blockreason-other)에서 다룹니다.

## 구 SDK와 preview ID 코드에서 옮길 때 바꿀 것

2026년 초까지의 튜토리얼 코드는 대부분 구 SDK와 preview ID를 씁니다. 현재 Google 문서 기준으로 바꿔야 할 부분은 다음과 같습니다.

| 예전 코드 | 지금 |
|---|---|
| `pip install google-generativeai`, `import google.generativeai as genai` | `pip install google-genai`, `from google import genai` |
| `genai.configure(api_key=...)` + `genai.GenerativeModel(...)` | `client = genai.Client()` 후 `client.interactions.create(...)` 또는 generateContent |
| `gemini-3-pro-image-preview` | `gemini-3-pro-image` |
| `gemini-3.1-flash-image-preview` | `gemini-3.1-flash-image` |
| `gemini-2.5-flash-image` | `gemini-3.1-flash-lite-image`(Google 권장) |
| Imagen 4의 `:predict` 엔드포인트와 `personGeneration` | `gemini-3.1-flash-image`. Gemini 이미지 모델에는 인물 생성 on/off 같은 스위치가 없음 |

Node.js는 `@google/genai` 패키지의 `GoogleGenAI`를 쓰고, 호출 형식은 Python과 같은 `ai.interactions.create({ model, input, response_format })`입니다. 공식 JSON·YAML 템플릿으로 Pro를 호출하는 예시는 [나노 바나나 프로 API 사용법](https://blog.laozhang.ai/ko/posts/nano-banana-pro-api-guide)에도 있습니다.

## 자주 묻는 질문

### Gemini API 키 발급은 무료인가요?

키 발급 자체는 무료이고 AI Studio에서 바로 만들 수 있습니다. 다만 Nano Banana 2 Lite, Nano Banana 2, Nano Banana Pro는 모두 이미지 출력에 무료 티어가 없어서, 키만 있고 결제가 연결되지 않은 프로젝트로는 이미지를 받을 수 없습니다. 이미지를 생성하려면 결제 계정을 연결하고 최소 $5를 선불 충전해야 합니다.

### API 없이 무료로 Gemini 이미지를 만들어 볼 수는 없나요?

코드 연동이 아니라 이미지만 필요하다면 Gemini 앱이 무료 계정에서도 Nano Banana 2로 이미지를 만듭니다. 장수 한도와 다른 무료 경로는 [제미나이 이미지 생성 방법: 앱에서 API까지](https://blog.laozhang.ai/ko/posts/gemini-image-generation-complete-guide)에 정리돼 있습니다. 앱에서 만든 이미지는 API 요금과 무관하지만, 앱을 코드에서 호출할 수는 없습니다.

### Gemini API와 Vertex AI로 호출하는 것은 무엇이 다른가요?

같은 Nano Banana 모델을 쓰고, Vertex AI(Global)의 토큰 단가도 Gemini API와 같습니다. 차이는 Google Cloud 프로젝트의 결제와 인증 체계를 따른다는 점입니다. 회사의 Cloud 계정과 권한 관리 안에서 써야 한다면 Vertex AI가 맞습니다. 모델 ID와 설정은 [Vertex AI 나노 바나나 API: 현재 모델 ID·인증·비용](https://blog.laozhang.ai/ko/posts/vertex-ai-nano-banana-api)을 참고하세요.

### API로 만든 이미지에도 워터마크가 들어가나요?

Google 가이드에 따르면 생성된 모든 이미지에 눈에 보이지 않는 SynthID 워터마크가 들어가며, 이것은 끌 수 없습니다. 눈에 보이는 반짝임 모양 워터마크는 Gemini 앱의 설정 문제이고, 한국에서는 AI Ultra 구독자만 그 설정을 바꿀 수 있습니다.

### Gemini 3 API에서 이미지를 만드는 모델은 어느 것인가요?

이미지를 출력하는 모델은 `gemini-3.1-flash-lite-image`, `gemini-3.1-flash-image`, `gemini-3-pro-image` 세 가지입니다. Gemini 3 계열의 텍스트 모델에 이미지를 입력하면 이미지를 읽고 설명할 수는 있지만, 이미지를 생성하지는 않습니다.

## 참고 자료

이 글이 링크한 외부 페이지를 본문에 나온 순서대로 정리했습니다. 마지막 업데이트: 2026-10-05.

- [Gemini API 가격 페이지](https://ai.google.dev/gemini-api/docs/pricing) (ai.google.dev)
- [이미지 생성 가이드](https://ai.google.dev/gemini-api/docs/image-generation) (ai.google.dev)
- [Google 지원 중단 일정](https://ai.google.dev/gemini-api/docs/deprecations) (ai.google.dev)
- [Gemini API 이용 가능 지역](https://ai.google.dev/gemini-api/docs/available-regions) (ai.google.dev)
- [Google AI Studio](https://aistudio.google.com/) (aistudio.google.com)
- [결제 문서](https://ai.google.dev/gemini-api/docs/billing) (ai.google.dev)
- [요청 한도 문서](https://ai.google.dev/gemini-api/docs/rate-limits) (ai.google.dev)