# Gemini API 무료 티어 모델 목록, 하루 한도보다 먼저 확인할 것

> 2026년 10월 10일 기준 Gemini API 무료 모델은 gemini-3.8-flash 등 Flash 계열입니다. 결제 후에도 무료 등급 할당량이 걸리면 키의 프로젝트와 결제 계정부터 확인합니다.

- Source: https://www.aifreeapi.com/ko/posts/google-gemini-api-free-tier
- Language: ko
- Published: 2026-01-16
- Updated: 2026-10-10
- Publisher: AI Free API (https://www.aifreeapi.com)

**2026년 10월 10일 기준으로 Gemini Developer API에는 무료 티어(공식 한국어 문서의 표기로는 무료 등급)가 있고, 입력과 출력이 모두 무료인 텍스트 모델은 Flash와 Flash-Lite 계열입니다.** 새 프로젝트라면 `gemini-3.8-flash`나 `gemini-3.5-flash-lite`로 시작하면 됩니다. 현행 Pro(`gemini-3.1-pro-preview`)와 이미지, 동영상, 음악 모델은 API로 쓰려면 결제가 필요합니다. 한국은 Google AI Studio와 Gemini API 지원 지역에 포함되어 있어, 프로젝트와 API 키만 만들면 바로 호출할 수 있습니다.

“하루 몇 번 무료인가?”에는 모든 사용자에게 통하는 숫자 하나가 없습니다. 모델 가격표와 프로젝트에 실제로 부여된 쿼터가 서로 다른 정보이기 때문입니다. 무료 티어를 제대로 판단하려면 모델, 프로젝트, 데이터, 운영 요구를 함께 봐야 합니다.

반대로 결제 계정을 연결했고 AI Studio에도 Tier 1로 나오는데 429 응답에 `free_tier`가 들어간 할당량 이름이 찍힌다면, 모델이 아니라 등급이 적용되는 경로를 봐야 합니다. 요청에 쓴 API 키가 결제된 프로젝트에서 나왔는지, 결제 계정이 Google Cloud 무료 체험판이나 연체 상태가 아닌지, 결제 후 10분이 지났는지를 차례로 확인합니다. 단계별 확인 위치와 무료 등급으로 되돌리는 방법은 아래 「결제 연결했는데 무료 등급 할당량이 걸릴 때 확인 순서」 절에 있습니다.

![Gemini API 무료 티어: 결제 계정은 Tier 1인데 API 키는 free_tier로 남은 상태를 키, 프로젝트, 결제 계정 순으로 거슬러 확인하는 구조와 무료 모델 gemini-3.8-flash](https://www.aifreeapi.com/posts/ko/google-gemini-api-free-tier/img/cover.webp)

## Gemini API에서 무료로 쓸 수 있는 모델: Flash·Flash-Lite 계열 ID 목록

Google의 [Gemini Developer API 가격 페이지](https://ai.google.dev/gemini-api/docs/pricing)는 모델마다 무료 티어 열과 유료 열을 나눠 표시합니다. 2026년 10월 10일 기준으로 무료 티어 열의 입력·출력 가격이 모두 `Free of charge`인 텍스트 모델은 다음과 같습니다. 상태는 [모델 목록 페이지](https://ai.google.dev/gemini-api/docs/models)와 [지원 중단 페이지](https://ai.google.dev/gemini-api/docs/deprecations)의 표기입니다.

| 모델 ID | 상태 | 참고 |
|---|---|---|
| `gemini-3.8-flash` | Stable | 최신 Flash. 새 프로젝트에 안내되는 모델 |
| `gemini-3.5-flash-lite` | Stable | 가벼운 작업용. 새 프로젝트에 안내되는 모델 |
| `gemini-3.6-flash` | Stable | 가격 페이지 표기는 이전 세대 Flash |
| `gemini-3.1-flash-lite` | Stable | |
| `gemini-3-flash-preview` | Preview | 가격 페이지 표기는 “legacy Flash model” |
| `gemini-2.5-pro`, `gemini-2.5-flash`, `gemini-2.5-flash-lite` | 2.5 세대 | 과거에 활발히 쓴 사용자에게만 열려 있음 |
| `gemini-3.7-flash`, `gemini-3.5-flash` | 자동 전환 | 가격표와 모델 목록에서 빠졌고, 요청은 각각 `gemini-3.8-flash`, `gemini-3.6-flash`로 처리됨 |

![Gemini API 모델을 무료 호출 가능, 조건부, 결제 필요로 나눈 2026년 10월 10일 기준 지도](https://www.aifreeapi.com/posts/ko/google-gemini-api-free-tier/img/free-models.webp)

`gemini-3.7-flash`나 `gemini-3.5-flash`를 적어 둔 코드는 당장 멈추지 않지만, 응답은 다른 모델이 만듭니다. 동작을 고정하려면 실제로 처리하는 모델 ID로 바꿔 두는 편이 낫습니다.

텍스트 모델 외에도 무료 행이 있습니다.

- Live API: `gemini-3.8-live`, `gemini-3.8-live-extended-thinking`, `gemini-3.1-flash-live-preview`
- 음성 인식과 통역: `gemini-3.5-transcribe`, `gemini-3.5-transcribe-live`, `gemini-3.5-live-translate-preview`
- 음성 합성(TTS): `gemini-3.8-flash-tts`, `gemini-3.8-flash-lite-tts`, `gemini-3.1-flash-tts-preview`, `gemini-2.5-flash-preview-tts`
- 임베딩: Gemini Embedding 2
- Gemma 4: 무료 티어에서만 제공되고 유료 열은 “Not available”입니다.

무료 티어에서 쓸 수 있는 도구도 같은 페이지에 있습니다. Google 검색으로 그라운딩은 하루 500회까지 무료이고 Flash와 Flash-Lite가 이 횟수를 함께 씁니다. 코드 실행, URL 컨텍스트, 파일 검색은 무료이며 Computer use는 무료 티어에서 쓸 수 없습니다.

용도별로 어떤 모델을 고를지는 [Gemini 텍스트 모델 비교: Flash, Flash-Lite, Pro 선택법](/ko/posts/gemini-3-0-api)에서, `gemini-3.8-flash`의 사양과 유료 가격은 [Gemini 3.8 Flash API 가이드](/ko/posts/gemini-3-8-flash)에서 이어서 볼 수 있습니다.

## 결제가 필요한 모델: 현행 Pro, 이미지, 동영상, 음악

같은 가격 페이지에서 무료 티어 열이 “Not available”인 모델은 API로 호출하려면 결제를 연결해야 합니다.

| 종류 | 모델 |
|---|---|
| Pro 텍스트 | `gemini-3.1-pro-preview`, `gemini-3.1-pro-preview-customtools` |
| 이미지 | `gemini-nano-banana-2.1`(Nano Banana 2.1), `gemini-3.1-flash-image`(Nano Banana 2), `gemini-3.1-flash-lite-image`(Nano Banana 2 Lite), `gemini-3-pro-image`(Nano Banana Pro), `gemini-2.5-flash-image` |
| 동영상 | `gemini-omni-1.1-flash`, `gemini-omni-flash-preview`, Veo 3.1 |
| 음악 | Lyria 3.5, Lyria 3 |
| 음성 합성 | `gemini-2.5-pro-preview-tts` |

“Pro가 무료인가”라는 질문은 모델명을 붙여야 답할 수 있습니다. 현행 Pro인 `gemini-3.1-pro-preview`에는 무료 행이 없습니다. 무료 행이 있는 Pro는 이전 세대인 `gemini-2.5-pro`뿐이고, 이 모델은 아래에서 설명하는 2.5 세대 제한을 받습니다.

`gemini-2.5-flash-image`도 무료 행이 없습니다. 가격 페이지에는 아직 2026년 10월 2일 종료 경고가 남아 있지만, 지원 중단 페이지는 종료일을 2027년 3월 15일로 미루고 대체 모델을 `gemini-3.1-flash-lite-image`로 적고 있습니다. 오래된 예제에 이 ID가 남아 있다면 종료 전에 `gemini-3.1-flash-lite-image`나 `gemini-3.1-flash-image`로 옮기면 됩니다. 2026년 10월 6일에 나온 `gemini-nano-banana-2.1`은 `gemini-3.1-flash-image`의 후속으로 안내되며 역시 무료 행이 없습니다. 이미지 생성을 무료로 써 볼 수 있는 경로는 [Gemini 이미지 무료 티어 2026: 앱 일일 한도와 API 현실](/ko/posts/gemini-image-free-tier-2026)에서 따로 다룹니다.

## 가격표에 무료로 나와도 호출이 안 되는 세 가지 경우

오래된 글이나 AI 답변에서 가져온 모델명을 넣었다가 오류나 결제 설정 요구를 만났다면 대개 다음 셋 중 하나입니다.

**새 프로젝트에서 2.5 세대를 호출한 경우.** Google의 모델 목록 페이지는 2.5 모델의 접근을 과거에 활발히 사용한 사용자로 제한하고 있으며, 새 프로젝트에는 3.5 Flash-Lite나 3.8 Flash를 쓰라고 안내합니다. 2.5 모델이 지원 중단된 것은 아니지만, 가격표의 무료 행만 보고 새 프로젝트를 `gemini-2.5-pro`나 `gemini-2.5-flash`에 맞춰 설계하면 안 됩니다. “활발히 사용”의 기준은 공개되어 있지 않습니다.

**Preview 모델이거나 이미 종료된 모델인 경우.** Google은 Preview 모델에 대해 대체로 결제가 켜져 있어야 하고, 한도가 더 엄격할 수 있으며, 최소 2주 전 공지 후 종료될 수 있다고 설명합니다. `gemini-3-flash-preview`는 무료 행이 있지만 이 조건을 받는 Preview 모델입니다. “Gemini 3 Flash”는 이 Preview 모델 하나의 이름이지 현행 Flash 전체를 가리키는 말이 아닙니다. `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-3.1-flash-lite-preview`, `gemini-3-pro-preview`는 이미 종료되어 호출할 수 없습니다.

**AI Studio 화면에서만 써 볼 수 있는 모델인 경우.** 가격 페이지는 `gemini-3.1-pro-preview`, Nano Banana 2, Nano Banana Pro에 “Can be tested in Google AI Studio”라는 각주를 붙여 둡니다. 이는 AI Studio 웹 화면에서 시험해 볼 수 있다는 뜻이고, 같은 모델을 API 키로 무료 호출할 수 있다는 뜻이 아닙니다.

`gemini-flash-latest` 같은 별칭은 새 모델이 나올 때마다 가리키는 대상이 바뀝니다. 실험에는 편하지만, 동작을 고정해야 하는 서비스에서는 위 표의 Stable 모델 ID를 그대로 적는 편이 안전합니다.

## Gemini 앱 무료 요금제는 API 무료 티어와 다른 상품이다

“제미나이 무료 모델”이라는 말은 Gemini 앱의 무료 요금제를 가리킬 때도 쓰입니다. 앱 요금제와 API 무료 티어는 모델 구성도, 한도를 세는 방식도 다릅니다.

2026년 10월 1일 [Google 요금제 페이지](https://gemini.google/subscriptions/)에 적힌 내용으로는 Gemini 앱 무료 요금제가 3.6 Flash를 사용하고, 3.1 Pro 접근 권한은 변동될 수 있으며, 이미지 생성과 편집, Deep Research, Gemini Live, Canvas, Gem이 포함됩니다. 앱의 한도는 요청 횟수가 아니라 프롬프트의 복잡도, 사용한 기능, 대화 길이에 따른 연산량으로 계산되고, 주간 한도에 닿기 전까지 5시간마다 초기화됩니다. 요금제의 구성과 가격은 국가에 따라 다를 수 있습니다.

따라서 앱에서 3.1 Pro나 이미지 생성을 무료로 써 봤다고 해서 API 키로 같은 모델을 무료 호출할 수 있는 것은 아닙니다. 반대로 API 무료 티어의 Flash 모델 목록이 앱에서 고를 수 있는 모델을 알려 주지도 않습니다.

## 무료 모델과 무료 쿼터는 같은 말이 아니다

가격표의 무료 행은 적격 호출의 토큰 가격이 0이라는 사실만 알려 줍니다. 내 프로젝트가 분당·일일 얼마나 처리할 수 있는지는 가격표에 없습니다. Google은 모델별 무료 한도를 문서에 표로 공개하지 않으며, 프로젝트에 실제 적용되는 값은 AI Studio에서 확인하도록 안내합니다.

Gemini API에 무료 티어가 있다는 사실만으로 이미지, 동영상, Pro, Preview를 포함한 모든 모델을 무료로 쓸 수 있다고 판단하면 안 되는 것처럼, 무료 행이 있다는 사실만으로 필요한 처리량이 보장된다고 판단해서도 안 됩니다. 모델 ID와 가격은 새 모델이 나올 때마다 바뀌므로 구현하는 날 가격 페이지를 다시 확인하는 것이 안전합니다.

## 내 프로젝트에서 RPM·TPM·RPD 확인하기

Google의 [비율 제한 문서](https://ai.google.dev/gemini-api/docs/rate-limits)는 세 가지 핵심 지표를 설명합니다.

| 지표 | 의미 | 자주 발생하는 상황 |
|---|---|---|
| RPM | 분당 요청 수 | 짧은 요청을 동시에 많이 보냄 |
| TPM | 분당 입력 토큰 수 | 긴 문서나 큰 컨텍스트를 처리함 |
| RPD | 일일 요청 수 | 일정 시간 잘 동작하다 하루치가 소진됨 |

RPD는 태평양 시간 자정에 초기화됩니다. 한국 시간 자정이 아닙니다. 이 제한들은 API 키가 아니라 **프로젝트 단위**로 적용됩니다. 같은 프로젝트에서 키를 여러 개 만들어도 쿼터가 늘어나지 않습니다. 개발 노트북, 스테이징, 크론 작업, 앱 서버가 한 프로젝트를 공유하면 같은 풀을 소비합니다.

Preview와 실험 모델은 더 엄격한 제한을 가질 수 있습니다. Google은 표시된 제한이 실제 처리 용량을 보장하지 않는다고도 밝힙니다. 과거 글의 고정 RPM/RPD 숫자를 현재 내 계정의 약속으로 사용하기 어려운 이유입니다.

정확한 확인 순서는 다음과 같습니다.

1. API 키가 속한 프로젝트를 확인합니다.
2. AI Studio에서 그 프로젝트의 실제 적용 한도를 엽니다.
3. 사용할 정확한 모델 ID를 선택합니다.
4. RPM, TPM, RPD와 현재 사용 등급을 기록합니다.
5. 같은 프로젝트를 쓰는 모든 작업의 트래픽을 합쳐 계산합니다.

문서 분석처럼 한 번에 많은 토큰을 보내는 서비스는 요청 횟수가 적어도 TPM이 먼저 소진될 수 있습니다. 짧은 채팅을 동시에 처리하면 RPM이 먼저 문제가 됩니다. “하루 몇 번”만 보면 이런 병목을 놓칩니다. 결제 후 등급별로 한도가 어떻게 달라지는지는 [Gemini API 사용 등급별 요청 한도](/ko/posts/gemini-api-rate-limits-per-tier)에서 이어집니다.

## 현재 SDK와 gemini-3.8-flash로 첫 요청 보내기

Google의 [최신 시작 가이드](https://ai.google.dev/gemini-api/docs/get-started)는 Interactions API와 `google-genai` SDK를 사용합니다. AI Studio는 신규 사용자에게 프로젝트와 API 키를 자동으로 만들어 줍니다. 키는 코드가 아니라 환경 변수에 둡니다.

```bash
export GEMINI_API_KEY="YOUR_API_KEY"
pip install -U google-genai
```

가격표에 무료 입력·출력이 표시되고 새 프로젝트에 안내되는 `gemini-3.8-flash`로 최소 호출을 보낼 수 있습니다.

```python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="벡터 데이터베이스를 세 문장으로 설명해 줘.",
)

print(interaction.output_text)
```

응답을 받은 뒤 AI Studio 사용량 화면에서 예상한 프로젝트에 기록됐는지 확인하세요. 환경 변수가 다른 키를 가리키거나, 키가 다른 프로젝트에 속하거나, 모델 ID가 오래된 문제를 여기서 잡을 수 있습니다. 무료 키라도 공개 프런트엔드에 넣거나 Git에 커밋해서는 안 됩니다.

## 429를 한 종류의 오류로 보지 않기

`429 RESOURCE_EXHAUSTED`가 발생했을 때 무조건 재시도하면 일일 한도를 더 빨리 회복시킬 수 없습니다.

- 동시 요청 직후라면 RPM을 확인하고 병렬 수를 줄인 뒤 지터가 있는 지수 백오프를 적용합니다.
- 적은 요청인데 입력이 크다면 TPM을 확인하고 문서를 나누거나 입력을 줄입니다.
- 한동안 동작한 후 남은 하루 동안 멈췄다면 RPD를 확인합니다.
- 여러 키가 동시에 실패하면 키보다 공유 프로젝트를 먼저 봅니다.
- Preview 모델만 불안정하면 용도에 맞는 Stable 모델과 비교합니다.
- 결제를 연결한 프로젝트인데 오류 본문에 `free_tier`가 들어간 할당량 이름이 있으면 한도 소진이 아니라 등급이 적용되는 경로의 문제입니다. 아래 「결제 연결했는데 무료 등급 할당량이 걸릴 때 확인 순서」로 넘어갑니다.

짧은 제한 창에는 재시도가 유효하지만, RPD 소진에는 다음 초기화나 유료 전환이 필요합니다. 400이나 500으로 실패한 요청은 토큰 요금이 청구되지 않아도 쿼터에는 계산되므로, 잘못된 요청을 반복해서 보내면 무료 한도가 그만큼 줄어듭니다. 다른 오류까지 구분하려면 [Gemini API 429·400·500 오류를 가장 빨리 해결하는 방법](/ko/posts/gemini-api-error-fix-2026-429-400-500)을 참고할 수 있습니다.

## 민감한 데이터는 무료 티어 판단을 바꾼다

Google의 [Gemini API 추가 약관](https://ai.google.dev/gemini-api/terms)에 따르면 비유료 서비스에 제출한 콘텐츠와 생성된 응답은 Google 제품과 머신러닝 기술을 제공·개선·개발하는 데 사용될 수 있습니다. 사람 검토자가 처리할 가능성도 있으며, Google은 민감한 정보, 기밀 정보, 개인 정보를 제출하지 말라고 안내합니다.

고객 기록, 비공개 코드, 계약서, 의료·금융 자료에는 남은 무료 요청 수보다 이 조건이 더 중요합니다. 유료 서비스의 프롬프트와 응답은 Google 제품 개선에 사용되지 않지만, 조직의 보안·보관·규제 검토는 별도로 필요합니다.

[지원 지역 목록](https://ai.google.dev/gemini-api/docs/available-regions)에서 한국은 제공 지역입니다. 다만 현재 약관은 EEA, 스위스, 영국 사용자에게 API 클라이언트를 제공할 때 유료 서비스만 사용하도록 규정합니다. 그 지역의 개발자가 자기 테스트에 무료 티어를 쓰는 것은 가능하지만, 그 지역 사용자에게 공개하는 앱은 유료 서비스로 돌려야 합니다. 개발자의 위치만 보고 공개 서비스의 무료 사용 가능 여부를 결정하면 안 됩니다.

## 결제를 켜야 하는 순간: 최소 선불 5달러, 잔액 0이면 402

학습, 해커톤, 낮은 트래픽의 내부 도구처럼 중단 비용이 작고 비민감 데이터만 처리한다면 무료 티어가 잘 맞습니다. 다음 조건 중 하나가 생기면 유료 전환이 더 단순한 엔지니어링 선택입니다.

- 현행 Pro, 이미지, 동영상, 음악처럼 무료 행이 없는 모델을 API로 써야 합니다.
- 실제 사용자가 용량 변화에 영향을 받습니다.
- 큐와 재시도로도 필요한 응답성을 만들기 어렵습니다.
- 비유료 약관에 맞지 않는 데이터를 처리합니다.
- 최종 사용자 지역 때문에 유료 서비스가 필요합니다.
- 무료 한도를 보호하는 운영 비용이 예상 API 비용보다 큽니다.

Google의 [결제 가이드](https://ai.google.dev/gemini-api/docs/billing)는 무료에서 유료로 전환할 때 결제 계정을 연결하고 크레딧을 선불로 구매하도록 설명합니다. 2026년 10월 10일 기준 최소 구매 금액은 **미화 5달러**(또는 현지 통화 상당액)이며, 지역과 등급에 따른 실제 최소 금액은 결제 화면에 표시됩니다. 결제 계정을 연결하면 무료 티어에서 Tier 1로의 전환은 보통 즉시 적용됩니다. 키는 프로젝트의 등급과 결제 상태를 상속합니다.

선불 방식에서 알아 둘 점은 세 가지입니다.

- 구매한 크레딧은 12개월 뒤 만료됩니다.
- 잔액이 0달러가 되면 그 결제 계정에 연결된 프로젝트의 요청은 HTTP 402로 실패합니다. 프로젝트가 무료 티어로 자동 전환되지 않습니다.
- 무료 티어로 돌아가려면 프로젝트에서 결제 계정 연결을 해제합니다. 절차와 그 뒤에 남는 것은 아래 「Gemini API 무료 등급으로 되돌리기」에 정리되어 있습니다.

일반 Google Cloud 신규 사용자용 300달러 크레딧과 혼동하면 안 됩니다. Google은 2026년 3월 2일 이후 개설된 결제 계정의 환영 크레딧을 Gemini API와 AI Studio 요금에 사용할 수 없다고 밝힙니다. 결제를 켠 뒤에도 지출 한도, 선불 잔액, RPM·TPM·RPD를 계속 모니터링해야 합니다.

키 발급부터 결제 연결, 등급 상승 조건까지의 절차는 [Gemini API 키는 사는 것이 아닙니다: 발급, 결제, 등급 가이드](/ko/posts/gemini-api-key-tiers)에, 모델별 토큰 요금 구조는 [Gemini API 토큰 가격 가이드](/ko/posts/gemini-api-token-pricing)에 있습니다.

## 결제 연결했는데 무료 등급 할당량이 걸릴 때 확인 순서

결제 계정을 연결하고 AI Studio에 Tier 1이 표시되는데도 요청이 무료 등급 할당량으로 처리된다면, 원인은 크게 두 갈래입니다. 실패하는 요청이 결제된 프로젝트 밖에서 오고 있거나, 결제 계정이 아직 유료 등급 자격을 갖추지 못한 경우입니다. 이 둘을 지운 뒤에도 남는 경우는 Google 쪽 계정 플래그나 일시적 오류로 봅니다.

출발점은 등급이 붙는 구조입니다. Google [결제 문서](https://ai.google.dev/gemini-api/docs/billing)(2026년 9월 28일 갱신)에 따르면 사용 등급, 비율 제한, 지출 한도는 모두 **결제 계정 단위**로 정해지고, 그 결제 계정에 연결된 프로젝트가 등급을 상속합니다. API 키에는 별도의 결제 설정이 없고, 키를 만든 프로젝트의 등급과 결제 상태를 그대로 따릅니다. 그래서 확인도 실패한 요청의 키에서 시작해 프로젝트, 결제 계정 순으로 거슬러 올라갑니다.

![결제를 연결했는데 무료 등급 할당량이 걸릴 때 API 키, 프로젝트, 결제 계정, 반영 시간, Workspace 순으로 확인하는 순서](https://www.aifreeapi.com/posts/ko/google-gemini-api-free-tier/img/billing-free-tier-check.webp)

### 429 본문의 free_tier 할당량 이름으로 증상부터 구분하기

같은 “결제했는데 안 된다”도 응답에 따라 갈 곳이 다릅니다. 확인 순서에 들어가기 전에 실패한 요청의 응답 본문 전체를 봅니다.

| 응답에 보이는 것 | 의미 | 다음 행동 |
|---|---|---|
| 429와 `generate_content_free_tier_requests`, `GenerateRequestsPerMinutePerProjectPerModel-FreeTier` 같은 이름 | 이 요청이 무료 등급 할당량으로 평가됨 | 아래 1~5단계 |
| 이미지·Pro 모델에서만 위 이름과 `limit: 0`, 텍스트 모델은 성공 | 같은 원인. 무료 등급이 없는 모델은 무료로 평가되는 순간 한도가 0 | 아래 1~5단계 |
| HTTP 402 Payment Required | 선불 잔액이 0. 무료 등급으로 내려간 것이 아님 | AI Studio 결제 페이지에서 크레딧 구매 |
| 429인데 `free_tier` 이름이 없음 | 유료 등급의 한도. 10분 단위 지출 한도(Tier 1은 10달러)일 수도 있음 | [Gemini API 사용 등급별 요청 한도](/ko/posts/gemini-api-rate-limits-per-tier) |
| 403 “Your project has been denied access”, 프로젝트 옆 “Unavailable” | 계정에 걸린 플래그 | 아래 4·5단계 |

Google의 [문제 해결 문서](https://ai.google.dev/gemini-api/docs/troubleshooting)는 400, 402, 403을 재시도하지 말라고 안내합니다. 무료 등급 할당량으로 평가되는 429도 원인이 그대로라면 재시도해서 풀리지 않습니다. 텍스트 모델은 무료 등급의 낮은 한도(포럼의 한 보고에서는 분당 5회)까지는 성공하기 때문에, 처음에는 잘 되다가 요청이 몰릴 때만 실패하는 형태로 나타나기도 합니다.

### 1단계: 실패한 요청의 API 키가 결제된 프로젝트에서 나왔는지

AI Studio는 신규 사용자에게 기본 프로젝트와 키를 자동으로 만들어 줍니다. 그래서 한 계정 안에 결제를 연결한 프로젝트와 결제가 없는 기본 프로젝트가 나란히 있을 수 있고, 결제가 없는 쪽에서 만든 키는 다른 프로젝트가 Tier 1이어도 무료 등급으로 동작합니다.

- **AI Studio API 키 페이지**: 실패한 요청에 쓴 키가 어느 프로젝트에 속하는지, 그 프로젝트의 Plan 열이 “Paid”인지 봅니다.
- **AI Studio 프로젝트 페이지**: Billing Tier 열과 Status 열을 봅니다. “Set up billing”은 결제 계정이 연결되지 않은 프로젝트, “Set up Prepay”는 결제 계정은 있지만 선불(Prepay) 설정이 남은 프로젝트, “No credits”는 선불 설정이 안 됐거나 잔액이 바닥난 상태입니다.
- **실제 실행 환경**: 서버, CI, 배포 플랫폼의 환경 변수에 들어 있는 키가 AI Studio에서 확인한 키와 같은지 대조합니다. 노트북에서는 되는데 서버에서만 실패한다면 두 환경의 키가 다른지부터 봅니다.
- **Google Cloud 콘솔**: 키를 만든 프로젝트가 실제로 그 결제 계정에 연결되어 있는지 프로젝트의 결제 화면에서 확인합니다.

Google AI 개발자 포럼에서 Google 직원은 2026년 8월 11일 답변에서 “결제 계정이 활성이어도 API 키를 만든 프로젝트가 그 결제 계정에 연결되어 있지 않으면 이 오류가 난다”고 [설명했고](https://discuss.ai.google.dev/t/bug-paid-tier-1-project-incorrectly-using-free-tier-quota-429-limit-0-on-gemini-3-1-flash-lite-image/177634), 7월 7일 다른 사례에서는 프로젝트를 조회해 보니 429 기록이 없었다며 호출에 쓴 프로젝트와 키가 섞였을 가능성을 [지적했습니다](https://discuss.ai.google.dev/t/gemini-3-1-flash-tts-preview-still-hitting-free-tier-quota-limit-3-despite-tier-2-billing/173252). 8월 21일 답변에서는 Tier 1 프로젝트를 지정해 AI Studio에서 새 키를 만들고 그 키로 요청하라고 [안내했습니다](https://discuss.ai.google.dev/t/gemini-api-tier-1-project-incorrectly-enforced-as-free-tier-for-gemini-3-1-flash-image/176192).

**넘어가는 조건**: 실패한 요청의 키가 Plan “Paid”, Tier 1 이상인 프로젝트에 속하고, 그 행에 “Set up billing”, “Set up Prepay”, “No credits”가 없다.

### 2단계: 결제 계정 상태 — 무료 체험판, 연체, 후불 계정

프로젝트가 맞다면 결제 계정 자체를 봅니다. 확인 위치는 AI Studio가 아니라 [Google Cloud 콘솔의 결제 페이지](https://console.cloud.google.com/billing)입니다. 여기서 말하는 Google Cloud 무료 체험판(Free Trial)은 Gemini API 무료 등급(Free Tier)과 다른 것입니다.

- **결제 계정이 아직 무료 체험판 상태.** 결제 문서는 AI Studio 결제 화면에 “The billing account type is inactive or unsupported”가 나오면 결제 계정 유형이나 상태가 유료 등급 대상이 아니라는 뜻이고, 그 예로 무료 체험판 계정과 해지된(Closed) 계정을 듭니다. Google 직원은 2026년 9월 8일, 선불 잔액이 있는데도 무료 등급 한도가 걸린 프로젝트에 대해 연결된 결제 계정이 무료 체험판 상태라서 그렇다며, Cloud 콘솔 결제 페이지에서 업그레이드를 마친 뒤 AI Studio에서 선불 크레딧을 넣으라고 [답했습니다](https://discuss.ai.google.dev/t/gemini-api-project-stuck-on-free-tier-despite-active-billing-and-prepaid-credits/181805). 같은 답변에서 “수동으로 결제 상태를 동기화하는 수단은 없다”고도 밝혔습니다.
- **300달러 크레딧만 있는 경우.** 2026년 3월 2일 이후 개설한 결제 계정의 환영 크레딧은 Gemini API에 쓸 수 없고, 선불 사용자는 선불 크레딧을 먼저 구매해야 Gemini API에 쓸 수 있는 다른 Cloud 크레딧도 적용되기 시작합니다. 2026년 3월 GitHub에는 Cloud 콘솔에서 크레딧이 있는 결제 계정을 연결하고 API를 켠 뒤 키를 만들었는데도 무료 등급 할당량이 걸린다는 [보고](https://github.com/google-gemini/api-examples/issues/98)가 올라왔지만 Google의 답은 없습니다. 문서 기준으로 추론하면, Cloud 콘솔에서 연결만 하고 AI Studio의 결제 설정(최소 5달러 선불)을 마치지 않은 상태로 볼 수 있습니다.
- **연체, 결제 거절, 만료된 결제 수단.** 다른 Google Cloud 서비스의 후불 요금이 밀려 있어도 같은 결제 계정의 Gemini API는 선불 잔액과 관계없이 중단됩니다. Cloud 콘솔 결제 페이지에서 먼저 해결해야 합니다.
- **선불 설정을 중간에 취소한 경우.** 기존 후불 계정에 선불을 추가하다가 확인 화면 이후 창을 닫으면 결제 계정이 청구 불가 상태로 남아, 연결된 프로젝트가 모두 영향을 받을 수 있습니다. 설정을 끝까지 마치거나 Cloud 결제 지원팀에 상태 초기화를 요청합니다.
- **후불(Postpay) 계정.** Google 직원은 2026년 7월 29일, 후불 Tier 1 프로젝트에 무료 등급 한도가 걸린 사례를 결제 계정의 결제 이력이 적기 때문이라고 설명하며 선불·사전 결제로 이력을 만들거나 결제 이력이 있는 다른 결제 계정을 연결하라고 [안내했습니다](https://discuss.ai.google.dev/t/gemini-api-tier-1-project-incorrectly-enforced-as-free-tier-for-gemini-3-1-flash-image/176192). 8월 12일 다른 사례에는 후불 결제 계정에 선불 금액을 넣었는지 확인하라며 “선불 금액과 관계없이 결제 계정이 승급 기준에 도달해야 한다”고 짧게 [답했습니다](https://discuss.ai.google.dev/t/billing-enabled-but-api-keys-still-showing-free-tier/177837). 두 답변 모두 결제 문서에는 없는 설명입니다.

**넘어가는 조건**: Cloud 콘솔에서 결제 계정이 무료 체험판이나 해지 상태가 아닌 정상 계정이고 미납이 없으며, AI Studio 결제 페이지에 선불 잔액이 0보다 크거나 후불 계정이 정상으로 표시된다.

### 3단계: 등급 승급 반영 시간 — 카드 결제 후 10분, 계좌이체는 며칠

결제 문서는 결제가 성공하거나 승급 기준을 채운 뒤 등급 변경이 보통 10분 안에 반영된다고 적고, [비율 제한 문서](https://ai.google.dev/gemini-api/docs/rate-limits)는 무료에서 Tier 1로의 승급이 보통 즉시 적용된다고 적습니다. 카드 결제는 대부분 바로 확정되지만 계좌이체 같은 수단은 확정까지 며칠이 걸릴 수 있고, 서비스는 크레딧 구매가 공식 확정된 뒤에야 승급됩니다.

따라서 카드로 결제한 지 10분이 넘었다면 기다림은 더 이상 설명이 되지 않습니다. 1·2단계로 돌아가거나 4·5단계로 넘어갑니다. 결제 페이지의 비용 그래프는 갱신에 최대 24시간이 걸리므로 등급 반영 여부를 판단하는 기준으로 쓰지 않습니다. 계좌이체라면 결제가 확정됐는지부터 확인합니다.

### 4단계: Workspace 계정 프로젝트의 “Unavailable” 보고

“Workspace 계정에는 무료 등급이 없다”는 말이 있지만, 2026년 10월 10일 기준 Google 문서에는 그런 내용이 없습니다. [Workspace 안내 문서](https://ai.google.dev/gemini-api/docs/workspace)는 AI Studio가 모든 Workspace 버전에서 기본으로 켜져 있고, 관리자가 조직 단위별로 끌 수 있으며, Workspace for Education의 18세 미만 사용자는 쓸 수 없다고만 적습니다. 결제 문서도 무료 등급 제공 여부를 지역 기준으로만 설명합니다.

다만 보고는 있습니다. 2026년 2월 12일 note.com의 [사용자 글](https://note.com/shiratama1126/n/n72061bdea6b1)은 Workspace 계정에서 새 키의 첫 요청이 429로 실패하고 결제가 없는 프로젝트의 등급 표시가 “Unavailable”이었으며, 같은 절차가 개인 @gmail.com 계정에서는 동작했다고 적었습니다. 글쓴이는 Workspace 조직의 프로젝트에는 무료 등급이 배정되지 않는 것으로 결론 내리면서 공식 문서에 없는 내용이라고 덧붙였습니다. 2026년 9월에는 Workspace(교육용 포함) 프로젝트가 “Billing Tier: Unavailable / Status: Restricted”로 표시되고 403 “Your project has been denied access”와 “Please set up billing to continue” 안내가 나온다는 [포럼 보고](https://discuss.ai.google.dev/t/gemini-api-free-tier-all-projects-restricted-generatecontent-403/185647)가 이어졌습니다.

Google 직원은 이 “Unavailable” 표시와 403을 계정에 걸린 자동 플래그로 설명하며, 무료 등급에서 쓸 수 있는 모델인지 AI Studio 비율 제한 대시보드에서 확인하고, 연령 인증·전화 인증·2단계 인증을 마친 뒤 새 키로 다시 시도하라고 [안내합니다](https://discuss.ai.google.dev/t/403-permission-denied-your-project-has-been-denied-access-on-fresh-workspace-project/182714). 그래도 풀리지 않으면 결제를 연결하라고 권하는데, 그러면 무료 등급 할당량은 쓸 수 없게 됩니다. 같은 표시는 [개인 Gmail 계정에서도 보고](https://discuss.ai.google.dev/t/403-permission-denied-project-denied-access-quota-tier-unavailable-on-new-free-tier-project-models-list-returns-200/177132)되어, Workspace만의 현상이라고 단정할 수는 없습니다.

결제를 연결한 Workspace 사용자에게 이 내용이 중요한 이유는 1단계와 이어지기 때문입니다. 결제된 프로젝트 옆에 결제가 없는 Workspace 프로젝트가 있고 그쪽 키가 쓰이고 있다면, 그 요청은 무료 등급조차 받지 못하고 실패할 수 있습니다. 확인 방법은 같은 모델과 같은 요청 본문을 개인 Google 계정이 소유한 프로젝트의 키로 보내 보는 것입니다. 개인 계정에서는 되고 Workspace 프로젝트에서만 실패한다면 키 설정이 아니라 계정·조직 쪽 원인입니다. “you do not have access to Google AI Studio” 같은 메시지가 나오면 Workspace 관리자가 AI Studio를 꺼 둔 것이므로 관리자에게 요청합니다.

### 5단계: 모두 통과했는데도 무료 등급이면 Google 쪽 원인과 문의 방법

Google은 정상적으로 결제된 Tier 1 프로젝트가 무료 등급 할당량을 받는 조건 목록도, 사용자가 직접 결제 상태를 다시 동기화하는 수단도 공개하지 않습니다. 남는 원인으로 Google 직원이 포럼에서 밝힌 것은 두 가지입니다.

- **계정 플래그.** 2026년 7월 20일 답변에서 Google 직원은 결제했는데 다시 무료 등급으로 돌아간 사례를 자동 플래그로 보고, AI Studio의 프로젝트 페이지와 결제 페이지에 다음 조치나 이의 제기 링크가 담긴 배너가 있는지 확인하라고 [안내했습니다](https://discuss.ai.google.dev/t/gemini-api-stuck-on-free-tier-after-enabling-billing/175230). 배너가 없으면 임시 한도 상향을 신청하는 방법을 제시했습니다. 프로젝트에 연결된 이메일 주소로 안내가 오는 경우도 있습니다.
- **일시적 백엔드 오류.** 2026년 9월 2일, Tier 1 선불 프로젝트의 모든 요청이 48시간 넘게 429로 실패한 사례에 Google 직원은 일시적 백엔드 오류였고 해결됐다고 [답했습니다](https://discuss.ai.google.dev/t/429-resource-exhausted-on-paid-tier-1-quota-appears-stuck-on-free-tier-limits-despite-active-billing/180368). 2026년 4월에는 이미지 모델의 `free_tier ... limit: 0` 오류가 아무것도 바꾸지 않았는데 다음 날 사라졌다는 [보고](https://discuss.ai.google.dev/t/tier-1-billing-enabled-but-gemini-image-model-still-returns-free-tier-quota-limit-0-429-resource-exhausted/139497)도 있습니다.

문의는 결제 문서가 안내하는 Cloud 결제 지원이나 [Google AI 개발자 포럼](https://discuss.ai.google.dev/)으로 합니다. 프로젝트 번호, 결제 계정 ID, 실패한 요청 시각, 할당량 이름이 보이는 429 응답 본문 전체를 준비하고, **API 키는 어디에도 올리지 않습니다.** 포럼에서는 Google 직원이 프로젝트 번호를 개인 메시지로 요청하는 경우가 많습니다. 실수로 키가 노출됐다면 바로 삭제하고 새로 만듭니다.

## Gemini API 무료 등급으로 되돌리기: 프로젝트별 결제 사용 중지

유료 등급에서 무료 등급으로 돌아갈 수 있습니다. 결제 문서의 방법은 무료로 되돌릴 **프로젝트마다 결제를 사용 중지**하는 것, 즉 프로젝트와 결제 계정의 연결을 해제하는 것입니다. 선불 잔액을 다 써서 0이 되는 것으로는 내려가지 않고, 그 상태에서는 무료 등급이 아니라 402 오류가 납니다.

[Google Cloud 결제 문서](https://docs.cloud.google.com/billing/docs/how-to/modify-project)의 콘솔 절차는 다음과 같습니다.

1. Google Cloud 콘솔의 결제(Billing)에서 My Projects를 열거나, 해당 결제 계정의 Account management를 엽니다.
2. 프로젝트 옆에 자물쇠 아이콘이 있으면 먼저 연결 잠금을 풉니다. 잠긴 상태에서는 결제를 끌 수 없습니다.
3. 프로젝트 행의 작업(Actions, 점 세 개) 메뉴에서 “Disable billing”을 고르고, 확인 창에서 다시 “Disable billing”을 누릅니다.

이 작업에는 프로젝트의 Project Billing Manager와 Project Browser 역할(또는 Project Owner), 결제 계정의 Billing Account Viewer 이상 역할이 필요합니다. 같은 문서는 AI Studio의 Gemini API 프로젝트가 무료 사용 등급으로 바뀐다고 적는 동시에, 그 프로젝트의 다른 유료 Google Cloud 서비스는 모두 멈추고 일부 리소스는 복구할 수 없게 삭제될 수 있다고 경고합니다. Gemini 외의 서비스를 함께 돌리는 프로젝트라면 먼저 백업하거나 Gemini 용도를 별도 프로젝트로 분리합니다. 나중에 결제를 다시 켜면 리소스가 재시작되기까지 최대 24시간이 걸릴 수 있습니다.

결제를 끈 뒤 달라지는 것과 남는 것은 다음과 같습니다.

| 항목 | 결과 |
|---|---|
| 그 프로젝트의 한도와 모델 | 무료 등급 한도로 돌아가고, 무료 행이 없는 Pro·이미지·동영상 모델은 `limit: 0`으로 실패 |
| 선불 크레딧 | 프로젝트가 아니라 결제 계정에 남음. 구매 후 12개월에 만료되고 원칙적으로 환불되지 않음 |
| 결제 계정 해지 | 남은 선불 크레딧을 잃음 |
| 같은 결제 계정의 다른 프로젝트 | 그대로 유료 등급. 무료로 돌릴 프로젝트마다 따로 결제를 꺼야 함 |
| 이미 쓴 요금 | 이전 결제 계정의 결제 수단으로 청구됨 |
| API 데이터 처리 | 비유료 서비스 약관 적용. 입력과 응답이 제품 개선에 쓰일 수 있음 |

AI Studio 화면에서 입력한 프롬프트는 결제가 켜진 API 프로젝트가 하나라도 있는 동안 유료 서비스 약관으로 처리된다고 결제 문서에 적혀 있습니다. 문서에서 바로 이어지는 추론이지만, 모든 프로젝트의 결제를 끄면 AI Studio 프롬프트도 비유료 조건으로 돌아간다고 보는 것이 안전합니다. 민감한 데이터를 다루던 프로젝트라면 위 「민감한 데이터는 무료 티어 판단을 바꾼다」의 조건을 다시 확인합니다.

꼭 내려갈 필요가 없는 경우도 있습니다. 결제 문서는 유료 프로젝트와 무료 프로젝트를 각각의 API 키로 구분해 필요에 따라 오갈 수 있다고 설명합니다. 실험은 결제가 없는 프로젝트의 키로, 서비스는 유료 프로젝트의 키로 나눠 두면 결제를 끄고 켜지 않아도 됩니다. 이때도 1단계처럼 어느 키가 어느 프로젝트 소속인지 분명히 관리해야 합니다.

## 짧게 답하는 질문: 무료 한도, Pro, 결제 계정, 무료 등급 복귀

### Gemini API 무료 한도는 얼마인가요?

모든 프로젝트에 공통으로 적용되는 숫자는 공개되어 있지 않습니다. Google 문서에는 모델별 무료 RPM·TPM·RPD 표가 없고, 한도는 프로젝트 단위로 정해지며 AI Studio에서 확인하도록 되어 있습니다. 문서에 숫자로 적힌 무료 한도는 Google 검색으로 그라운딩의 하루 500회 같은 도구 항목입니다.

### Gemini Pro 모델은 API에서 무료인가요?

현행 Pro인 `gemini-3.1-pro-preview`는 무료 행이 없어 결제가 필요합니다. `gemini-2.5-pro`에는 무료 행이 있지만 과거에 2.5 모델을 활발히 쓴 사용자에게만 열려 있어, 새 프로젝트에서는 기대하기 어렵습니다.

### 결제 계정 없이 Gemini API를 쓸 수 있나요?

쓸 수 있습니다. 새 계정은 무료 티어에서 시작하고, AI Studio가 프로젝트와 API 키를 만들어 주므로 결제 계정을 연결하지 않아도 무료 행이 있는 모델을 호출할 수 있습니다. 결제 계정은 유료 전용 모델이나 더 높은 한도가 필요해질 때 연결합니다.

### Gemini API 결제를 했는데 왜 무료 등급 할당량이 적용되나요?

가장 먼저 의심할 것은 요청에 쓴 API 키가 결제를 연결한 프로젝트가 아닌 다른 프로젝트(예: 자동으로 만들어진 기본 프로젝트)에 속한 경우입니다. 그다음은 결제 계정이 Google Cloud 무료 체험판이거나 미납이 있는 경우, 후불 계정의 결제 이력이 부족한 경우입니다. 카드 결제 후 10분이 지났다면 반영 시간 문제는 아니며, 모든 확인을 통과했다면 프로젝트 번호와 429 본문을 준비해 Google에 문의합니다.

### Gemini API 유료 등급에서 무료 등급으로 돌아갈 수 있나요?

돌아갈 수 있습니다. Google Cloud 콘솔에서 무료로 되돌릴 프로젝트마다 결제를 사용 중지하면 그 프로젝트는 무료 등급이 됩니다. 선불 크레딧은 결제 계정에 남아 구매 후 12개월에 만료되고, 같은 결제 계정의 다른 프로젝트는 유료 등급을 유지합니다.

## 숫자가 바뀌어도 유지되는 답: 모델 ID와 프로젝트 한도를 직접 확인하기

Gemini API 무료 티어는 지금도 프로토타입과 학습에 충분히 유용합니다. 다만 오래가는 사용법은 고정된 하루 숫자나 누군가 정리한 모델 목록을 외우는 것이 아닙니다. 지원 지역을 확인하고, 가격 페이지에서 정확한 모델 ID의 무료 행을 찾고, AI Studio에서 프로젝트의 실제 한도를 읽고, 최소 요청으로 사용량을 확인하세요. 결제를 연결한 뒤에도 같은 원칙이 적용됩니다. 등급은 결제 계정에서 프로젝트를 거쳐 키로 내려오므로, 문제가 생기면 그 경로를 거꾸로 따라가며 확인합니다.

데이터 보호, 안정성, 사용자 지역, 운영 비용이 주된 제약이 되는 순간에는 무료 티어를 더 오래 버티는 것보다 결제 또는 다른 공식 경로를 선택하는 편이 합리적입니다.