제미나이 API를 사용하던 일부 개발자들이 어느 날 갑자기 ‘prepayment credits depleted’ 오류를 겪으며 당혹감을 표하고 있다. 멀쩡히 사용하던 후불결제 계정이 선불결제로 전환되면서 API 호출이 중단되는 상황이 발생하고 있다. 이는 단순한 시스템 오류가 아니라 2026년 구글의 결제 정책 변경에 따른 것으로 파악된다.
✅ 이 글 요약
- 전환 배경: 2026년 3월 23일 구글의 결제 정책 개편으로 기존 후불 계정 다수가 선불로 전환.
- 후불 전환 조건: Tier 3 계정만 가능하며, 누적 지출 $1,000 이상 및 첫 결제 후 30일 경과.
- 크레딧 오류: 선불 전환 후 기존 Cloud 크레딧은 Gemini API에 적용 불가, Vertex AI에서는 사용 가능.
- 대안: Tier 3 미달 시 Vertex AI로 전환하여 기존 Google Cloud 크레딧 활용 가능.
제미나이 API 선불결제 및 후불결제 차이점
제미나이 API의 결제 방식은 크게 선불과 후불로 나뉜다. 이 두 방식은 구조적으로 큰 차이를 보인다. 선불결제는 사용자가 크레딧을 미리 구매하고, API 사용량에 따라 잔액에서 실시간으로 차감되는 방식이다. 이는 예상치 못한 과다 청구를 방지하는 데 효과적이지만, 잔액이 소진되면 API 호출이 중단된다는 단점이 있다.
반면 후불결제는 한 달간 사용한 만큼 월말에 청구서를 받아 정산하는 방식이다. 크레딧을 미리 구매하거나 만료일을 신경 쓸 필요가 없으나, 선불결제처럼 지출을 특정 잔액 내로 제한하는 기능은 없다. 현재 모든 유료 사용자는 선불결제를 이용할 수 있지만, 후불결제는 특정 조건을 충족하는 Tier 3 계정에서만 선택이 가능하다.
결제 방식별 주요 특징
선불결제는 사용 전 크레딧을 구매하며, 최소 10달러에서 최대 5,000달러까지 구매할 수 있다. 구매한 크레딧은 12개월 후 만료된다. 반면 후불결제는 사용 후 월간 청구되며, 별도의 잔액 한도나 크레딧 만료 기간이 없다. 구글은 이와 같은 결제 체계를 통해 사용자들이 자신의 사용량 패턴에 맞춰 결제 방식을 선택할 수 있도록 하고 있다.
후불결제가 선불결제로 바뀐 배경
멀쩡하게 후불결제를 사용하던 계정이 선불결제로 바뀐 주요 원인은 2026년 구글이 단행한 제미나이 API 결제 구조 개편 때문이다. 이 개편은 2025년 8월 발생했던 대형 결제 사고의 여파로 진행됐다. 당시 가격 산정 오류로 일부 개발자가 수만 달러에 달하는 예상치 못한 요금을 청구받았고, 최대 7만 달러 이상이 부과된 사례도 보고됐다.
이러한 문제 발생 후, 구글은 2026년 3월 23일부터 결제 방식을 선불 중심으로 재편했다. 이에 따라 신규 가입자는 의무적으로 선불결제로 시작하게 되었고, 기존 사용자 계정 역시 이력과 티어 상태에 따라 선불 또는 후불로 자동 배정됐다. 이 과정에서 상당수의 기존 후불결제 계정이 선불결제로 강제 전환된 것으로 파악된다. 구글은 사전 경고나 별도 메일 없이 정책을 전환하면서, 서비스 운영 중이던 많은 사용자들이 갑작스러운 오류로 인해 불편을 겪은 것으로 전해졌다.
제미나이 API 후불결제 전환 자격 조건
제미나이 API의 선불결제에서 후불결제로 다시 변경하려면 특정 자격 조건을 충족해야 한다. 구글의 정책에 따르면, 후불결제는 Tier 3 계정에서만 선택할 수 있다. Tier는 누적 지출액과 계정 사용 기간에 따라 자동으로 승급된다.
후불결제 전환의 핵심 자격인 Tier 3에 도달하기 위한 조건은 다음과 같다.
- 누적 지출: 결제 계정 누적 지출이 1,000달러(USD) 이상이어야 한다.
- 경과 기간: 첫 결제 성공 후 30일이 경과해야 한다.
위 두 가지 조건을 모두 충족하면 별도 신청 없이 자동으로 Tier 3에 진입하며, 보통 10분 이내에 반영된다고 구글 관계자는 설명했다. 하지만 지역이나 계정 상태에 따라 메뉴 노출 시점이 다를 수 있어, Google AI for Developers 공식 결제 문서에서 본인 티어 기준을 확인하는 것이 요구된다. Tier 1 또는 Tier 2 계정에서는 후불결제 옵션 자체가 메뉴에 노출되지 않는다.
제미나이 API 선불결제 후불결제 변경 방법
후불결제 전환 자격을 갖춘 사용자는 Google AI Studio 내에서 결제 방식을 변경할 수 있다. 변경 절차는 다음과 같다.
- Google AI Studio에 로그인한 후, 결제(Billing) 메뉴로 이동한다.
- 결제 설정 대화상자에서 요금제 선택 항목을 확인한다.
- 후불(사용 후 결제, Pay-as-you-go) 요금제가 노출되면 해당 옵션을 선택한다.
- Cloud Billing 계정 정보와 결제 수단을 연결하고 확인한다.
- 변경 사항을 저장하면 다음 결제 주기부터 후불 기준으로 청구된다.
만약 자격이 충분함에도 불구하고 결제 설정 대화상자에 후불 요금제 옵션이 보이지 않는다면, 시스템 반영 지연일 수 있으므로 시간을 두고 다시 확인하거나, Google AI Studio 지원센터에 문의하는 것이 필요하다. 이와 관련해 구글 관계자는 “화면 구성과 메뉴 명칭은 업데이트로 바뀔 수 있다. 정확한 클릭 경로는 전환 시점의 AI Studio 결제 페이지에서 다시 확인해야 한다”고 밝혔다.
선불 전환 후 크레딧 오류 및 Vertex AI 대안
선불결제로 전환된 사용자들 중에는 기존에 보유하던 Google Cloud 크레딧이 남아 있음에도 불구하고 제미나이 API에서 ‘prepayment credits depleted’ 오류가 발생하는 경우가 많다. 이는 버그가 아니라 구글의 결제 체계 변화 때문이다. 선불 전환 이후 Gemini API의 선불 크레딧과 일반 Google Cloud 크레딧이 별도로 취급되기 시작했다.
이에 따라 AI Studio 프로젝트가 Tier 1(Prepay)으로 표시되고, 크레딧 잔액이 0으로 뜨며 ‘No credits’ 상태가 된다. 심지어 신규 계정 300달러 무료 체험 크레딧도 Gemini API에는 적용되지 않는다. 기존에는 Cloud 크레딧으로 Gemini API를 사용할 수 있었으나, 현재는 일반 Gemini API(AI Studio)와 Vertex AI의 결제 체계가 분리된 상태다.
이러한 상황에서 당장 기존 Google Cloud 크레딧을 활용하고 싶다면 Vertex AI로 전환하는 방법이 현실적인 대안으로 제시된다. Vertex AI는 같은 제미나이 모델을 제공하면서도 결제 체계가 일반 Gemini API와 다르기 때문이다. Vertex AI에서는 기존에 쌓아둔 Google Cloud 크레딧을 그대로 사용할 수 있다. 다만, 인증 방식이 API 키가 아닌 JSON 기반으로 변경되므로 코드 일부를 수정해야 한다.
