Gemini API 무료 한도 초과 시 429 오류와 유료 전환 비용 계산

무료 한도 초과 증상 요약

Gemini API 무료 등급은 입력과 출력 토큰 모두 요금이 부과되지 않습니다. 따라서 무료 한도를 넘겼을 때 처음 나타나는 증상은 청구가 아니라 429 RESOURCE_EXHAUSTED 오류입니다. 이 오류 문구가 표시되면 원인은 잔액이 아니라 분당 또는 일일 요청 한도 도달입니다.

무료 등급의 구체적인 한도는 모델과 시점에 따라 바뀌며, 공식 문서도 고정된 숫자를 제시하지 않습니다. 따라서 Google AI Studio의 요금 한도 화면에서 현재 값을 직접 확인해야 하며, 외부 글에 적힌 수치를 그대로 사용하면 실제 운영과 어긋납니다.

무료 등급에는 비용과 별개로 데이터 사용 조건이 있습니다. 무료 등급에서 주고받은 데이터는 제품 개선에 사용될 수 있고, 유료 등급의 데이터는 그렇게 사용되지 않습니다. 사내 문서나 고객 데이터를 다루는 경우에는 요청량이 적더라도 유료 등급을 선택해야 합니다.

등급별 승급 조건과 청구 상한

등급은 신청하지 않아도 조건을 충족하면 자동으로 올라갑니다. Tier 1은 활성 결제 계정을 연결하면 적용되고, 그 위 등급은 누적 결제액과 경과 일수를 함께 봅니다.

등급별 승급 조건과 청구 상한을 비교한 표입니다.

10분 단위로 적용되는 지출 속도 상한도 별도로 있습니다. Tier 1은 10달러, Tier 2는 50달러, Tier 3은 200달러이며, 이 상한에 걸리면 청구 상한이 남아 있어도 요청이 거부됩니다. 짧은 시간에 대량 배치를 실행하는 작업은 이 상한에 먼저 도달합니다.

모델별 단가와 비용 계산 절차

비용은 100만 토큰당 단가에 실제 사용량을 곱한 값입니다. 입력과 출력 단가가 다르고 출력 단가가 훨씬 높으므로, 답변을 길게 받는 작업일수록 비용이 빠르게 늘어납니다.

모델별 입력·출력 100만 토큰당 단가를 비교한 표입니다.

하위 모델의 장점은 같은 작업을 훨씬 낮은 비용으로 처리한다는 것이고, 단점은 긴 추론이 필요한 작업에서 답변 품질이 떨어진다는 것입니다. 비용 계산 절차는 다음과 같습니다.

1. 최근 일주일 동안의 요청 수와 요청당 평균 입력·출력 토큰을 로그에서 추출해 월 단위로 환산합니다.
2. 환산한 입력 토큰을 100만으로 나눈 뒤 표의 입력 단가를 곱해 입력 비용을 구합니다.
3. 같은 방식으로 출력 토큰에 출력 단가를 곱하고, 두 값을 더한 결과를 콘솔의 사용량 화면과 대조해 확인합니다.
4. 계산 결과가 Tier 1 청구 상한인 250달러를 넘으면 결제 계정 설정 화면에서 상위 등급 조건을 먼저 확인합니다.
5. 같은 입력을 상위 모델과 하위 모델로 각각 실행하고, 품질 차이가 비용 차이를 정당화하는지 결과를 비교합니다.

예를 들어 월 입력 2,000만 토큰과 출력 200만 토큰을 사용하는 작업은 Gemini 2.5 Flash에서 입력 6달러와 출력 5달러로 11달러, Gemini 2.5 Pro에서 입력 25달러와 출력 20달러로 45달러입니다. 같은 작업의 비용이 약 네 배 차이 나므로, 모델 선택을 등급 선택보다 먼저 해야 합니다.

429 오류 반복 시 조치

429 오류가 표시되면 먼저 대기한 뒤 재시도하고, 오류가 반복되면 요청 빈도 자체를 낮춥니다. 무료 등급에서 계속 한도에 도달한다면 결제 계정을 연결해 Tier 1로 올리는 것이 공식 방법입니다. 유료 등급에서도 한도에 계속 도달하면 한도 상향을 요청할 수 있습니다.

실패 즉시 재시도를 반복하는 코드는 상황을 악화시키므로, 대기 시간을 점차 늘리며 재시도하도록 변경해야 합니다. 비용 부담으로 유료 전환이 어려운 경우에는 출력 길이를 제한하고 하위 모델로 변경하는 것이 효과적입니다. 출력 단가가 입력 단가보다 몇 배 높기 때문입니다.

청구액 검증과 비용 절감 대안

첫 달 청구서가 나오면 앞에서 계산한 값과 대조합니다. 실제 청구액이 계산값보다 크게 높으면 재시도 코드가 실패한 요청을 반복해 토큰을 중복 소모했을 가능성이 크므로, 로그에서 재시도 횟수를 확인해야 합니다.

계산이 맞다면 콘솔의 사용량 화면과 자체 로그의 토큰 합계가 비슷한 값으로 표시됩니다. 두 값이 크게 어긋나면 다른 프로젝트나 다른 도구가 같은 키를 사용하고 있는지 점검합니다. API 키는 환경 변수로 보관해 저장소에 올라가지 않도록 관리하고, 노출이 의심되면 즉시 재발급합니다.

무료 등급으로 감당되지 않고 유료 전환도 불가능한 경우에는 요청 방식을 바꾸는 것이 대안입니다. 요청을 모아 한 번에 처리하거나, 응답을 캐시해 같은 질문의 재요청을 없애는 방법이 있습니다.