✦제미나이 쉬운 안내
홈 › 이용 가이드
GEMINI GUIDE

제미나이 API 선불요금제|Tier1 250달러는 월 한도, 최초 청구 아님

제미나이 API 선불요금제(Prepay Billing) 도입 시기와 Tier1 Tier2 Tier3 월간 지출 상한, 250달러가 최초 청구가 아닌 이유, 선불 크레딧 구매 한도와 후불 전환 환불 기준을 정리했습니다.

최종 업데이트 2026.10.02 · Google 공식 자료 기준

제미나이 API 선불요금제|Tier1 250달러는 월 한도, 최초 청구 아님 안내 썸네일

제미나이 API 선불요금제(Prepay Billing)는 계정에 크레딧을 미리 충전해 두고 호출한 만큼 차감하는 방식으로, 2026년 3월 23일부터 후불(Postpay)과 함께 적용됐습니다. 결제 계좌를 연동하면 곧바로 250달러가 청구된다는 말이 돌지만 사실이 아닙니다. 250달러는 Tier 1의 월간 지출 상한이고, 실제 청구는 그달에 쓴 사용량만큼입니다. 선불 크레딧은 최소 5달러부터 최대 5,000달러까지 한 번에 충전할 수 있습니다.

이 글은 요금 체계를 먼저 풀고, 이어서 Google AI Studio 키 발급, 첫 요청, 키 보안, 오류 코드를 차례로 정리합니다. 일반 제미나이 웹 앱 구독(Google One)과 개발자용 Gemini API는 과금 체계가 완전히 별개라는 점도 함께 짚습니다.

제미나이 API 선불요금제란 무엇인가요

제미나이 API는 선불(Prepay)과 후불(Postpay) 두 결제 주기를 2026년 3월 23일부터 적용하고 있습니다. 선불요금제는 웹 앱 구독처럼 매달 정해진 금액을 내는 정기 구독이 아닙니다. 미리 충전한 크레딧에서 실제 호출량만큼 차감되고, 크레딧이 남아 있는 동안 계속 호출할 수 있습니다.

이 결제 주기는 웹 앱의 Google One 구독과 화면도 결제 수단도 따로 관리됩니다. API 결제 설정을 바꾼다고 개인 구독이 해지되거나 바뀌지 않으며, 구독 해지는 제미나이 해지·구독취소 방법에서 확인할 수 있습니다.

유료 Tier1 Tier2 Tier3 지출 상한은 어떻게 다른가요

유료 등급은 결제 이력에 따라 단계적으로 올라갑니다. 공식 결제 문서 기준으로 무료(Free) 등급은 활성 프로젝트나 무료 체험만 있으면 되고 별도 지출 상한이 없습니다. Tier 1은 결제 계좌를 연동하면 진입하며 월간 지출 상한(spend cap)은 $250입니다. Tier 2는 첫 결제 성공 후 3일이 지나고 누적 결제액이 $100을 넘으면 올라갈 수 있고 월 상한은 $2,000입니다. Tier 3는 첫 결제 성공 후 30일이 지나고 누적 결제액이 $1,000을 넘으면 진입하며 월 상한은 $20,000에서 $100,000 이상까지입니다.

웹 앱 구독 가격은 이 등급과 무관하므로 제미나이 요금제·가격에서 따로 비교하세요.

제미나이 API 선불요금제 250달러는 최초 청구가 아닙니다

공식 결제 문서에는 계좌를 연동하는 순간 250달러가 빠져나간다는 문장이 없습니다. 이 금액은 한 달 동안 쓸 수 있는 최대 한도일 뿐이고, 실제 청구는 그달에 호출한 사용량만큼 발생합니다. 사용량이 상한에 도달하면 초과 호출이 제한되므로, 걱정할 것은 일시 청구가 아니라 사용량과 상한의 간격입니다.

선불 크레딧 최소 구매 금액과 충전 한도

선불 방식에서는 크레딧을 미리 구매해야 합니다. 한 번에 구매할 수 있는 최소 금액은 $5, 한 번에 충전할 수 있는 최대 금액은 $5,000입니다. 원화 청구액은 결제 화면에서 최종 확인하세요.

이 금액은 결제 화면의 충전 단위이고 등급별 월간 지출 상한과는 다른 개념입니다. 크레딧을 충전해 두었어도 그달 사용량이 등급 상한을 넘으면 호출이 제한될 수 있습니다.

후불 전환·환불

선불·후불 방식이 시행되기 전부터 있던 계정은 평가를 거쳐 특정 방식이 배정되거나, 두 방식 중 하나를 고를 기회가 제공됩니다. 화면에 안내가 표시되면 그 안내에 따라 선택하면 됩니다.

이용 자격이 있는 계정이 선불 주기에서 후불 주기로 수동 전환하면, 남은 선불 크레딧 잔액은 처음 선불 결제에 사용한 결제 수단으로 자동 환불됩니다. 전환 전에 잔액을 확인해 두면 환불 내역을 대조하기 쉽습니다.

앱과 API 차이

일반 사용자가 브라우저에서 접속하는 Gemini 웹 앱과 개발자가 코드로 호출하는 Gemini API는 목적과 요금 체계에서 큰 차이가 있습니다.

구분Gemini 웹/모바일 앱Gemini 개발자 API
주요 사용자일반 개인, 직장인, 학생소프트웨어 개발자, 시스템 엔지니어
인터페이스웹 브라우저 대화창, 스마트폰 앱 화면REST API, Python/JS SDK, cURL 요청
결제 및 구독Gemini 앱에 표시되는 구독 조건Gemini API의 무료 티어 또는 유료 종량제 조건
무료 제공 방식웹에서 기본 모델 무료 대화 제공개발자용 무료 티어(Free Tier) 분당 요청 한도 제공
데이터 프라이버시기본 설정 시 계정 활동 저장 및 학습 검토유료 티어 전환 시 입력 데이터 모델 학습 배제

Google One AI 프리미엄을 결제했다고 API 호출이 무제한 무료가 되지는 않습니다. 자체 개발 프로젝트에는 API 전용 할당량과 결제 프로젝트를 따로 관리해야 합니다.

키 발급

Google AI Studio에서 API 키를 만들 수 있으며, 무료 티어와 결제 설정 요구는 계정·지역·프로젝트에 따라 다릅니다.

  1. Google AI Studio 접속: 웹 브라우저에서 https://aistudio.google.com으로 이동합니다.
  2. 구글 계정 로그인: API를 관리할 구글 계정으로 로그인하고 이용 약관에 동의합니다.
  3. API 키 관리 화면 찾기: [Get API key] 또는 [API keys]에 해당하는 메뉴를 찾습니다. 명칭과 위치는 화면 개편에 따라 달라질 수 있습니다.
  4. 새 API 키 생성: 생성 항목을 선택하고 화면에서 요구하는 Google Cloud 프로젝트 연결 절차를 따릅니다.
  5. 발급된 키 복사 및 안전 보관: 생성된 긴 문자열 형태의 API 키(AIzaSy...)를 복사하여 안전한 메모장이나 비밀번호 관리자에 임시 보관합니다.

기본 화면 조작은 제미나이 사용방법에서 기초부터 볼 수 있습니다.

첫 요청

발급받은 키가 정상적으로 동작하는지 확인하기 위해 가장 널리 쓰이는 cURL 명령어와 Python 코드로 첫 테스트 요청을 보내는 방법입니다.

공식 API 문서의 generateContent 예제를 기준으로 요청 URL의 MODEL_NAME을 현재 지원되는 모델명으로 바꾸고, API 키는 소스에 직접 적지 말고 환경 변수에서 불러오세요. 요청 헤더에는 JSON 콘텐츠 형식을 지정하고 본문의 contents와 parts에 짧은 테스트 질문을 넣습니다.

SDK 이름과 메서드는 버전에 따라 바뀌므로 오래된 블로그 예제를 그대로 복사하지 말고, 설치한 버전에 맞는 공식 빠른 시작 예제에 GEMINI_API_KEY 환경 변수를 연결해 쓰세요.

첫 요청은 연결 성공 여부를 한 줄로 답해 달라는 식으로 짧게 보내고, 응답이나 오류 코드를 확인한 뒤 기능 개발로 넘어가세요.

제미나이 API 선불요금제란 무엇인가요

제미나이 API의 결제 방식은 크게 두 가지 결제 주기로 나뉘는데, 그중 하나가 선불(Prepay) 방식입니다. 구글은 선불(Prepay)과 후불(Postpay) 두 결제 주기를 2026년 3월 23일부터 적용하기 시작했다고 밝히고 있습니다.

선불요금제는 웹 앱 구독처럼 매달 정해진 금액을 미리 내는 정기 구독이 아닙니다. 계정에 미리 충전해 둔 크레딧에서 실제로 호출한 만큼 차감되는 방식이며, 남은 크레딧이 있는 동안 계속 호출할 수 있습니다.

이 결제 주기는 앞서 안내한 웹 앱의 Google One 구독과 완전히 별개의 화면과 결제 수단으로 관리됩니다. API 결제 계정 설정을 바꾸는 것이 개인 구독을 해지하거나 변경하는 것과 같은 절차는 아닙니다.

제미나이 API의 유료 등급은 결제 이력에 따라 단계적으로 올라가는 구조입니다. 공식 결제 문서는 등급별 진입 조건과 월간 지출 상한(spend cap)을 다음과 같이 안내합니다.

무료(Free) 등급은 활성 프로젝트나 무료 체험만 있으면 되고 별도의 지출 상한이 없습니다. Tier 1은 결제 계좌를 연동하기만 하면 진입하며, 월간 지출 상한은 $250입니다. Tier 2는 첫 결제 성공 후 3일이 지나고 누적 결제액이 $100을 넘으면 올라갈 수 있으며 월 상한은 $2,000입니다. Tier 3는 첫 결제 성공 후 30일이 지나고 누적 결제액이 $1,000을 넘으면 진입하며 월 상한은 $20,000에서 $100,000 이상까지로 안내돼 있습니다.

즉 등급이 올라갈수록 한 달에 쓸 수 있는 최대 금액이 커지는 구조이지, 등급에 진입하는 순간 그 금액이 청구되는 구조가 아닙니다. 요금제별 가격 자체를 비교하고 싶다면 제미나이 요금제·가격에서 웹 앱 구독 가격을 별도로 확인하세요.

결제 계좌를 연동하면 곧바로 250달러가 청구된다는 이야기가 개발자 커뮤니티에 돌고 있지만, 공식 결제 문서에는 그런 문장이 없습니다.

공식 문서가 밝히는 $250은 Tier 1 등급의 월간 지출 상한(spend cap)입니다. 다시 말해 한 달 동안 쓸 수 있는 최대 금액의 한도이며, 계좌를 연동한 순간 한 번에 빠져나가는 청구액이 아닙니다.

실제 청구는 그달에 실제로 호출한 사용량만큼 발생합니다. 사용량이 상한에 도달하면 그 이상은 초과 호출이 제한되므로, 갑자기 큰 금액이 한 번에 빠져나갈지 걱정하기보다 사용량과 상한을 함께 확인하는 것이 정확한 접근입니다.

선불 크레딧 최소 구매 금액과 충전 한도

선불(Prepay) 방식을 선택했다면 크레딧을 미리 구매해 충전해 두어야 합니다. 공식 문서에 따르면 한 번에 구매할 수 있는 최소 금액은 $5이고, 한 번에 충전할 수 있는 크레딧의 최대 금액은 $5,000입니다. 원화 청구액은 결제 화면에서 최종 확인하세요.

이 최소·최대 금액은 결제 화면에서 한 번에 처리할 수 있는 충전 단위를 뜻하며, 앞서 설명한 등급별 월간 지출 상한과는 다른 개념입니다. 크레딧을 충전해 두었어도 그달의 실제 사용량이 등급 상한을 넘으면 호출이 제한될 수 있습니다.

후불 전환·환불

선불·후불 방식이 도입되기 전부터 API를 후불로 쓰고 있던 계정은 어떻게 되는지도 자주 나오는 질문입니다.

공식 안내에 따르면 선불·후불 방식이 시행되기 전부터 있던 계정은 평가를 거쳐 특정 방식이 배정되거나, 두 방식 중 하나를 선택할 수 있는 기회가 제공됩니다. 화면에 안내가 표시되면 그 안내에 따라 방식을 확인하거나 선택하면 됩니다.

선불로 충전해 둔 크레딧을 다 쓰지 못하고 후불 방식으로 전환하는 경우도 있습니다.

공식 문서는 이용 자격이 있는 계정이 선불(Prepay) 주기에서 후불(Postpay) 주기로 수동 전환하면, 남아 있는 선불 크레딧 잔액이 처음 선불 결제에 사용한 결제 수단으로 자동 환불된다고 안내합니다. 전환 전에 잔액을 미리 확인해 두면 이후 환불 내역을 대조하기 쉽습니다.

무료·유료 한도

Google AI Studio는 개발자가 아이디어를 빠르게 프로토타이핑할 수 있도록 관대한 무료 등급(Free Tier)을 제공합니다. 상용 서비스로 배포할 때는 앞서 설명한 유료 등급과 결제 방식을 함께 고려해야 합니다.

무료 티어는 지원되는 모델과 지역에서 제공되며 모델·프로젝트별 분당·일일 호출 한도가 다릅니다. 현재 값은 공식 rate limits 화면에서 볼 수 있습니다. 무료 티어에서 입력한 데이터는 구글의 모델 성능 개선과 품질 검토에 쓰일 수 있습니다.

유료 등급은 모델과 입력·출력 유형별 단가가 다르고 모델·프로젝트별 제한도 적용됩니다. 민감정보 전송은 최소화하세요.

키 보안

API 키는 금융 계좌의 비밀번호와 같습니다. 키가 외부에 유출되면 타인이 내 할당량을 고갈시키거나 유료 결제 계정의 경우 막대한 요금 폭탄을 유발할 수 있습니다.

  1. 환경 변수 파일(.env) 사용: 코드 내부에 키를 직접 하드코딩하지 않고 .env 파일에 저장한 후 os.environ 또는 dotenv 라이브러리로 불러옵니다.
  2. .gitignore에 등록: Git 저장소를 사용할 때 .env 파일이 GitHub 등 공개 저장소에 푸시되지 않도록 .gitignore 파일에 반드시 .env를 추가합니다.
  3. 클라이언트 사이드 노출 금지: 리액트(React), 뷰(Vue), 일반 웹페이지 HTML/자바스크립트 등 브라우저 소스코드에서 API를 직접 호출하지 말고, 반드시 백엔드 API 서버를 거쳐 호출하도록 중계합니다.
  4. Google Cloud 콘솔에서 예산 알림 설정: 결제를 연결했다면 예산과 알림 기준을 설정합니다. 예산 알림은 비용을 자동 차단하는 기능과 다르므로 할당량 제한도 따로 확인하세요.

오류 해결

API 호출 시 가장 자주 발생하는 HTTP 에러 코드와 해결 방법입니다.

HTTP 상태 코드주요 원인조치 방법
400 Bad Request잘못된 JSON 포맷, 지원하지 않는 모델명, 비정상적 파라미터요청 본문 문법을 검토하고 공식 모델 목록에서 현재 유효한 모델명을 확인
403 Forbidden잘못된 API 키 입력, 프로젝트 권한 부족, 계정 지역 차단AI Studio에서 API 키 문자열을 다시 복사하여 대조하고 프로젝트 활성화 상태 확인
404 Not Found존재하지 않는 엔드포인트 URL 또는 단종된 구형 모델 호출API 요청 URL 주소와 모델명 철자를 최신 공식 문서 기준으로 수정
429 Too Many Requests무료 티어 분당 호출 한도(RPM) 또는 등급별 월 지출 상한 초과요청 간격을 늘리는 백오프(Exponential Backoff)를 적용하거나 상위 등급 조건 확인
500 / 503 Server Error구글 서버의 일시적 과부하 또는 네트워크 순단몇 초 후 지수 백오프 방식으로 자동 재시도(Retry) 로직 구현

네트워크·방화벽 환경의 추가 트러블슈팅은 제미나이 오류 해결을 참고하세요.

← 전체 가이드로 돌아가기