Gemini API 결제의 현재 상태는 가입 날짜가 아니라 로그인한 Google AI Studio 화면에서 확인해야 합니다. API 키는 결제 주체가 아닙니다. 키가 속한 프로젝트가 Cloud Billing 계정에 연결되고, 그 결제 계정의 플랜·결제 이력·사용량 등급이 비용과 중단 범위를 결정합니다.
한국어 검색에서 자주 묻는 다섯 가지를 먼저 답하면 다음과 같습니다.
| 질문 | 바로 확인할 답 |
|---|---|
| Gemini API 가격은? | 모델·기능별 사용량 가격과 결제 계정의 월간 한도는 서로 다릅니다. 전체 가격표는 공식 Pricing과 전용 가격 글에서 확인합니다. |
| 선불인가? | AI Studio Billing에 Prepay가 표시되면 먼저 credit을 넣고 사용합니다. 잔액 0은 무료 전환이 아니라 연결 프로젝트의 중단입니다. |
| 후불인가? | Postpay가 표시되면 사용액이 Cloud Billing에 누적됩니다. Tier 3라도 수동 전환 기능은 현재 일시 비활성화 상태입니다. |
| 결제가 왜 멈췄나? | 선불 잔액뿐 아니라 Cloud Billing의 미납, 카드 거절, 만료된 결제 수단도 확인합니다. |
| 한도에 걸렸나? | project spend cap, billing-account monthly cap, 모델별 rate limit, 10분 spend-rate limit을 따로 확인합니다. |
내 계정 상태를 60초 안에 적어 보기
Google AI Studio에서 Projects → Billing → Spend → Usage → Rate Limits 순서로 열고 아래 값을 한 줄씩 기록하세요. 공개 문서의 숫자는 계약을 설명하고, 로그인 화면은 내 계정의 실제 상태를 보여 줍니다.
| 상태 카드 | 어디서 확인하나 | 기록할 값 |
|---|---|---|
| 프로젝트 | Projects | API 키가 속한 Project ID |
| 결제 소유자 | Projects / Billing | 연결된 Billing account ID |
| 결제 플랜 | Billing | Free / Prepay / Postpay |
| 사용량 등급 | Billing / Rate Limits | Free / Tier 1 / Tier 2 / Tier 3 |
| 결제 가능 상태 | Billing / Cloud Billing Console | 선불 잔액 또는 후불 결제 상태 |
| 지출 통제 | Spend / Billing | project spend cap과 account monthly cap |
이 카드의 핵심은 API 키 → 프로젝트 → 결제 계정 → 플랜·등급·한도라는 소유 관계입니다. 같은 프로젝트에 키를 더 만들어도 별도 quota나 잔액이 생기지 않습니다. 반대로 프로젝트를 다른 Billing 계정으로 옮기면 새 결제 계정의 플랜과 tier를 물려받습니다. 기존 project spend cap 설정은 남을 수 있지만 새 결제 주기의 누적 project spend는 0에서 다시 표시됩니다.
선불과 후불: 내 화면에 표시된 플랜을 따른다
Google 공식 Billing 문서는 새 결제 플랜의 효력일을 2026년 3월 23일로 안내합니다. 그렇다고 그 날짜 이후 만든 모든 계정이 같은 플랜을 받는 것은 아닙니다. rollout과 자격에 따라 선불, 후불 또는 선택 화면이 다를 수 있으므로 블로그의 날짜표보다 내 Billing setup을 우선합니다.
선불(Prepay)일 때
- Free에서 Paid로 전환하며 선불이 배정되면 최소
$10또는 현지 통화 상당액을 충전합니다. 이는 키 가격이나 월 구독료가 아니라 API 사용에 차감되는 잔액입니다. - 최대 선불 잔액은
$5,000이고, 사용하지 않은 credit은 12개월 후 만료됩니다. 후불 전환 환불 절차를 제외하면 일반적으로 환불되지 않습니다. - 잔액이 0이면 같은 Billing 계정에 연결된 모든 Gemini API 프로젝트가 멈춥니다. Free tier로 자동 복귀하지 않습니다.
- 잔액 차감은 거의 실시간이지만 결제 처리에 최대 약 10분의 지연이 생길 수 있습니다. Batch나 오래 실행되는 agent는 그 사이 계속 비용을 만들 수 있습니다.
- 자동 충전은 잔액 trigger, 충전액, 월간 자동 결제 한도를 따로 설정합니다. 수동 충전은 월간 자동 결제 한도에 포함되지 않습니다.
잔액이 0 아래로 내려갔다면 다음 충전에서 마이너스 금액이 먼저 차감될 수 있습니다. 카드 결제는 빨리 확인될 수 있지만 은행 결제 등은 며칠 걸릴 수 있으므로 “충전 버튼을 눌렀다”가 아니라 “결제 확인과 서비스 복구가 완료됐다”까지 확인해야 합니다.
후불(Postpay)일 때
후불은 사용액이 Cloud Billing에 쌓이고 결제 주기에 청구됩니다. 새로운 setup에서 자격 있는 계정은 선불/후불 선택을 받을 수 있고, Tier 3 계정은 선불에서 후불로 바꿀 자격이 생길 수 있습니다. 그러나 공식 페이지는 수동 전환 옵션이 현재 일시 비활성화됐다고 명시합니다. Tier 3 달성만으로 버튼이 생긴다고 약속할 수 없습니다.
같은 Billing 계정을 Postpay로 바꾸면 연결된 프로젝트가 함께 영향을 받고, 같은 계정을 다시 Prepay로 되돌릴 수 없습니다. 전환이 가능한 시점에는 남은 선불 credit의 환불 절차와 결제 수단을 확인한 뒤 진행합니다.
사용량 등급과 결제 계정 월간 한도
사용량 등급은 API 키 나이도, 프로젝트 생성일도 아니라 Cloud Billing 계정의 누적 결제 이력으로 정해집니다. 같은 계정에 연결된 다른 Google Cloud 서비스 지출도 자격 계산에 포함됩니다.
아래 조건은 2026년 7월 22일 공식 문서에서 다시 확인한 값입니다.
| 등급 | 현재 자격 기준 | Billing-account monthly cap |
|---|---|---|
| Free | 활성 무료 프로젝트／무료 체험 | 지출 없음 |
| Tier 1 | 활성 Billing 계정을 설정하고 연결 | $250 |
| Tier 2 | 누적 결제 $100 이상 + 첫 완료 결제 후 3일 | $2,000 |
| Tier 3 | 누적 결제 $1,000 이상 + 첫 완료 결제 후 30일 | $20,000~$100,000+ |
조건을 충족하면 일반적으로 승급되지만 추가 검토로 거절될 수 있으며 quota increase도 보장되지 않습니다. Free→Tier 1은 보통 바로, 상위 tier는 보통 10분 안에 반영된다고 안내되지만, 실제 승급은 로그인 화면에서 확인한 뒤 트래픽을 늘려야 합니다.
Tier는 rate limit 자격에 영향을 주지만 “Tier 2 = 고정 RPM 몇 회”처럼 읽으면 안 됩니다. Google의 Rate limits 문서에 나온 모델별 값은 바뀔 수 있고 보장 capacity도 아닙니다. 내 active limit을 로그인 화면에서 확인하고, 429 원인과 RPM/TPM/RPD 진단은 Gemini API 요청 한도 가이드에서 별도로 다룹니다.
Gemini API 한도는 하나가 아니다
결제 사고를 막으려면 아래 여섯 항목을 각각 소유 단위와 시간창으로 구분해야 합니다.
1. Billing plan
Prepay인지 Postpay인지 정하는 결제 방식입니다. 사용량 등급이 높아지는 것과 같은 사건이 아닙니다.
2. Usage tier
Billing 계정의 결제 이력으로 정해지며 rate-limit 자격과 account cap의 틀을 제공합니다. 승급 조건을 충족해도 실제 승인과 처리 capacity는 보장되지 않습니다.
3. Billing-account monthly cap
같은 Billing 계정에서 Gemini API가 활성화된 프로젝트의 월간 지출을 합산합니다. 한도에 닿으면 연결된 대상 프로젝트가 다음 결제 주기까지 중단될 수 있습니다. 한 프로젝트만 보고 있으면 다른 프로젝트가 소비한 금액을 놓칩니다.
4. Project spend cap
한 프로젝트가 사용할 수 있는 월간 금액을 AI Studio에서 설정하는 실험적 통제입니다. 적절한 IAM 권한이 필요하고, 비용 처리에는 최대 약 10분 지연이 있어 Batch/agent가 cap을 넘을 수 있습니다. 회계상 절대 상한이 아니라 사고 범위를 줄이는 운영 장치로 사용합니다.
5. Cloud Billing budget
Cloud Billing Budget은 지출 threshold에서 알림을 보냅니다. API를 자동으로 멈추는 hard stop이 아니며, 이메일·프로그램 알림은 지연되거나 중복될 수 있습니다.
6. Spend-rate limit
최근의 짧은 시간창에서 프로젝트 지출 속도를 평가하는 rate limit입니다. 도달하면 429 RESOURCE_EXHAUSTED가 발생할 수 있지만, project spend cap이나 account monthly cap에 닿았다는 뜻은 아닙니다. 현재값은 로그인한 Rate Limits 화면에서 확인합니다.
서비스 중단 원인 매트릭스
중단 시 무조건 credit부터 사지 마세요. Google 공식 Troubleshooting과 대조할 수 있도록 먼저 에러 코드와 영향 범위를 기록하면 잘못된 조치를 피할 수 있습니다.
| 보이는 증상 | 가능한 원인 | 영향 범위 | 먼저 할 일 |
|---|---|---|---|
| Prepay 잔액 0 또는 음수 | 선불 credit 소진 | 같은 Billing 계정의 모든 Gemini API 프로젝트 | 필요한 금액을 충전하고 결제 확인을 기다림. Free 자동 복귀를 기대하지 않음 |
| 잔액은 남았지만 여러 프로젝트 중단 | 다른 Cloud 서비스 미납, 카드 거절, 만료된 결제 수단 | 공유 Billing 계정 | Cloud Billing Console에서 past-due와 payment method를 복구 |
| 특정 프로젝트만 중단 | project spend cap | 해당 프로젝트 | workload 이상 여부를 먼저 조사한 뒤 cap 변경 여부 결정 |
| 같은 계정의 프로젝트가 함께 중단 | billing-account monthly cap | 같은 계정의 Gemini 활성 프로젝트 | 합산 지출, tier, 다음 결제 주기, 승인된 상향 여부 확인 |
429 RESOURCE_EXHAUSTED | RPM, TPM, RPD, spend-rate 등 | 보통 해당 프로젝트 | active Rate Limits와 request rate/size를 대조. 무작정 충전하지 않음 |
400 FAILED_PRECONDITION | 요청 지역에서 Free tier 미지원 등 | 요청／프로젝트 조건 | 지역과 billing 필요 여부를 확인 |
403, 500, 503, 504 | 권한 또는 서비스 상태 등 | 원인별로 다름 | 결제 tier 문제로 단정하지 말고 공식 troubleshooting으로 코드별 진단 |
하나의 Cloud Billing 계정에서 Gemini API는 선불이고 다른 Cloud 서비스는 후불일 수 있습니다. 이때 다른 서비스의 미납이 결제 계정 전체를 정지시키면, Gemini 선불 잔액이 남아도 API가 멈출 수 있습니다. “잔액이 있는데 왜 중단됐지?”라는 질문은 AI Studio와 Cloud Billing Console을 함께 봐야 해결됩니다.
비용 breakdown 그래프는 최대24시간 늦을 수 있는 반면 credit 사용량과 tier 변경은 대체로 더 빨리 반영됩니다. 서로 다른 화면의 숫자가 잠시 맞지 않는다면 조회 시각과 대상 프로젝트/Billing 계정을 기록하고, 같은 데이터라고 가정하지 마세요.
가격을 확인할 때 월간 한도와 섞지 않기
모델별 Gemini API 가격은 입력/출력 token, context 길이, cache, Batch, 이미지·오디오·video, tools에 따라 달라집니다. Tier 1의 account cap이 $250이라고 해서 API 이용료가 월 $250인 구독 상품이라는 뜻은 아닙니다. 실제 사용량만 과금되며 cap은 그 tier에서 Billing 계정이 지출할 수 있는 상한입니다.
최신 모델별 단가는 Gemini API 가격 가이드에서 확인하세요. 무료 대상 모델과 무료 데이터 조건은 Gemini API 무료 사용 가이드에 분리했습니다. 이 글에서는 자주 바뀌는 모델별 가격표와 고정 quota를 복제하지 않습니다.
한국에서 결제할 때 확인할 것
Google의 현재 제공 지역 목록에는 대한민국이 포함됩니다. 다만 “한국에서 지원됨”은 모든 계정에 같은 원화 결제, 카드, 세금, invoice 조건이 제공된다는 뜻이 아닙니다.
- checkout에 표시되는 청구 통화와 실제 카드사 환율을 확인합니다.
- 부가세와 invoice 발행 주체를 내 결제 프로필에서 확인합니다.
- 개인 카드, 법인 카드, 은행 결제 등 표시되는 payment method를 그대로 기준으로 삼습니다.
- 조직 정책 때문에 AI Studio 프로젝트 연결이나 IAM 역할이 막히는지 확인합니다.
- 테스트 결제 후 Project ID와 Usage 기록이 같은지 대조합니다.
Google AI Pro/Ultra 같은 소비자 구독은 Gemini Developer API의 결제 플랜이나 tier와 별도 계약입니다. 구독 중이라는 이유로 API 후불, 더 높은 quota, 무료 credit을 가정하면 안 됩니다. Google Cloud Welcome/free-trial credit도 현재 Gemini API/AI Studio 사용에는 원칙적으로 적용되지 않으며, 과거의 적격 promotion credit은 만료일까지 예외가 있을 수 있습니다. 내 Billing 화면의 적용 여부가 최종 기준입니다.
상황별 안전한 다음 행동
Free에서 Paid로 바꾸려는 경우
- 필요한 모델 또는 active rate limit 때문에 유료가 필요한지 확인합니다.
- API 키가 속한 Project ID와 연결할 Billing account ID를 대조합니다.
- Billing setup이 제시하는 선불/후불 플랜을 확인합니다.
- 선불이면 최소 금액과 계정에 표시된 결제 통화·수단을 확인해 충전합니다.
- 작은 request를 보낸 뒤 Usage와 잔액/청구 내역이 같은 프로젝트에 기록되는지 검증합니다.
- project spend cap, Budget 알림, 애플리케이션 측 request 제한을 설정한 뒤 트래픽을 늘립니다.
Tier 승급이 필요한 경우
먼저 부족한 것이 월간 account cap인지, 모델별 RPM/TPM/RPD인지, 짧은 시간의 spend-rate인지 구분합니다. 누적 결제만 늘려도 현재 429가 즉시 사라진다고 약속할 수 없습니다. 자격을 충족한 뒤 실제 tier와 active limit이 바뀐 것을 확인하고 용량 테스트를 다시 합니다.
여러 프로젝트를 운영하는 경우
- 프로덕션, staging, 개인 실험을 프로젝트로 분리합니다.
- 각 프로젝트의 실제 트래픽과 실패 비용에 따라 spend cap을 정합니다. 근거 없는 고정 추천액을 복사하지 않습니다.
- account monthly cap은 전체 합산이므로 모든 프로젝트의 지출을 한 화면에서 검토합니다.
- 선불은 잔액·만료일·auto-reload를, 후불은 결제 수단·미납·청구 주기를 모니터링합니다.
- Batch와 agent에는 결제 계량보다 먼저 멈추는 자체 작업량 한도를 둡니다.
운영 체크리스트
- API 키마다 Project ID를 기록했다
- 각 project의 Billing account ID를 확인했다
- Free / Prepay / Postpay와 사용량 tier를 별도 항목으로 기록했다
- 선불 잔액 0이 Free 전환이 아니라는 점을 운영 문서에 적었다
- project spend cap과 account monthly cap을 구분했다
- Cloud Budget은 알림이지 hard stop이 아님을 확인했다
- 429 발생 시 active Rate Limits를 먼저 보는 절차가 있다
- Cloud Billing 미납과 payment method도 모니터링한다
- 원화, 환율, 세금, 결제 수단은 내 checkout/invoice에서 확인했다
정리하면 복구 순서는 간단합니다. 잔액 0이면 결제 확인 후 충전, 미납이면 Cloud Billing 복구, 특정 프로젝트만 멈췄다면 project cap 조사, 여러 프로젝트가 함께 멈췄다면 account cap과 결제 상태 확인, 429라면 rate-limit 차원 확인입니다. Gemini API 가격·선불·후불·결제·한도를 한 개의 “티어 문제”로 묶지 않는 것이 가장 빠른 진단법입니다.
