gemini api 가격 — 모델별 요금표와 무료 등급 차이
Gemini API 가격은 입력 토큰 × 입력 단가 + 출력 토큰 × 출력 단가로 정해지고, 생각(thinking) 토큰도 출력 단가로 청구됩니다. 2026년 10월 18일 공식 요금표 기준 100만 토큰당 Gemini 3.8 Flash가 입력 $0.75·출력 $3.75, 3.5 Flash-Lite가 $0.30·$2.50, 최상위 Gemini 4 Argon이 $2·$10입니다. 다만 Argon은 2026년 12월 1일, 3.8 Flash는 2027년 1월 1일부터 단가가 두 배로 오른다고 요금표에 적혀 있습니다. Flash 계열은 무료 등급으로도 쓸 수 있지만, 무료 등급에서 보낸 내용은 구글 제품 개선에 쓰입니다.
1. gemini api 가격표 — 모델별 단가
공식 요금 문서의 유료 등급 Standard 단가입니다(100만 토큰당 · 미국 달러 · 텍스트 기준 · 2026년 10월 18일 확인).
| 모델 | 입력 | 출력 (생각 포함) | 무료 등급 |
|---|---|---|---|
| Gemini 4 Argon | $2 → 12/1부터 $4 | $10 → 12/1부터 $20 | 없음 |
| Gemini 3.1 Pro Preview (프롬프트 20만 토큰 이하) | $2 | $12 | 없음 |
| Gemini 3.1 Pro Preview (20만 토큰 초과) | $4 | $18 | 없음 |
| Gemini 3.8 Flash · 3.6 Flash | $0.75 → 2027년부터 $1.50 | $3.75 → 2027년부터 $7.50 | 있음 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 | 있음 |
| Gemini 3.1 Flash-Lite | $0.25 | $1.50 | 있음 |
| Gemini 2.5 Flash-Lite | $0.10 | $0.40 | 있음 |
표에서 볼 것은 세 가지입니다.
- 지금 단가에 기한이 붙어 있습니다. 요금표에 Argon은 "2026년 11월 30일까지 $2, 12월 1일부터 $4", 3.8 Flash와 3.6 Flash는 "2026년 12월 31일까지 $0.75, 2027년 1월 1일부터 $1.50"처럼 날짜가 함께 적혀 있습니다. 캐싱·배치 단가도 같은 날 같이 두 배가 됩니다. 지금 단가로 예산을 잡았다면 그날 이후 비용이 두 배로 뛴다는 뜻입니다.
- 3.1 Pro Preview는 프롬프트 길이로 가격이 갈립니다. 한 요청의 입력이 20만 토큰을 넘으면 입력·출력 단가가 모두 높은 줄로 바뀝니다. 2.5 Pro도 같은 방식입니다($1.25·$10 → $2.50·$15).
- 음성은 단가가 따로입니다. 3.1 Flash-Lite는 음성 입력이 $0.50, 2.5 Flash-Lite는 $0.30처럼 텍스트·이미지·동영상보다 비쌉니다. PDF 같은 문서는 이미지 토큰 단가로 청구됩니다.
2. gemini api 가격 무료 — 무료 등급과 유료 등급 차이
새 계정은 무료 등급에서 시작합니다. AI Studio에서 프로젝트에 결제 계정을 연결하고 선불(Prepay)로 최소 $5를 충전하면 유료 등급(Tier 1)으로 넘어갑니다(계정에 따라 후불을 고르라는 화면이 나오기도 합니다). 두 등급의 차이는 단가만이 아닙니다.
| 항목 | 무료 등급 | 유료 등급 |
|---|---|---|
| 토큰 요금 | 무료 (일부 모델만) | 위 표 단가 |
| 쓸 수 있는 모델 | Flash·Flash-Lite 계열 등. 4 Argon·3.1 Pro Preview는 안 됨 | 전체 |
| 보낸 내용의 제품 개선 사용 | 사용됨 | 사용 안 됨 |
| 사용량 한도 | 낮음 | 등급이 오를수록 높아짐 |
고객 데이터나 회사 코드를 보낸다면 무료라는 이유만으로 무료 등급을 쓰면 안 되는 이유가 세 번째 줄입니다. 무료 등급에서 자주 만나는 RESOURCE_EXHAUSTED는 돈이 아니라 한도 문제이고, 원인 구분은 gemini api 429 에러 글에 정리해 두었습니다. 브라우저에서 쓰는 Google AI Studio는 지원 지역이면 무료입니다.
유료 등급 안에서도 결제 이력에 따라 월 지출 상한이 자동으로 정해집니다.
| 등급 | 조건 | 월 지출 상한 |
|---|---|---|
| Tier 1 | 결제 계정 연결 | $250 |
| Tier 2 | $100 결제 + 첫 결제 후 3일 | $2,000 |
| Tier 3 | $1,000 결제 + 첫 결제 후 30일 | $20,000~$100,000 이상 |
프로젝트마다 따로 상한을 걸고 싶으면 AI Studio의 Spend 페이지에서 Monthly spend cap을 정할 수 있습니다. 다만 공식 문서상 실험 기능이고, 약 10분 지연이 있어 그 사이 사용분은 상한을 넘어 청구될 수 있습니다. 키를 만드는 곳은 gemini api 키 발급 글에 있습니다.
3. gemini api 토큰 계산 — count_tokens로 미리 세기
공식 문서는 Gemini 모델에서 토큰 1개가 영어 기준 약 4글자라고 안내합니다. 한글은 이 어림값이 맞지 않으니 직접 세는 게 정확합니다. count_tokens는 요청을 보내기 전에 입력 토큰 수만 돌려줍니다(google-genai 2.31.0 기준). 키는 GEMINI_API_KEY 환경 변수에서 읽고, GOOGLE_API_KEY도 같이 있으면 그쪽이 우선합니다.
from google import genai
client = genai.Client()
prompt = "어제 받은 운동화가 사이즈가 안 맞아요. 교환되나요?"
for model in ["gemini-3.8-flash", "gemini-3.5-flash-lite"]:
r = client.models.count_tokens(model=model, contents=prompt)
print(model, r.total_tokens)
API 키 없이 SDK에 가짜 서버를 붙여 보면 이 호출은 모델마다 models/gemini-3.8-flash:countTokens 같은 주소로 따로 나가고, 응답의 totalTokens가 r.total_tokens로 들어옵니다. 실제 숫자는 키가 있는 환경에서 내 프롬프트로 재 보세요.
4. gemini api 가격 계산 — usage_metadata로 요청 하나 비용 보기
실제 청구에 가까운 값은 응답의 usage_metadata입니다. 여기서 헷갈리는 칸이 두 개 있습니다. SDK 타입 설명 기준으로 prompt_token_count는 캐시된 토큰을 포함한 값이고, 생각 토큰 thoughts_token_count는 답변 토큰 candidates_token_count와 별개 칸입니다. 그래서 캐시분은 빼서 캐시 단가로, 생각 토큰은 더해서 출력 단가로 계산합니다.
# 100만 토큰당 달러 (2026-10-18 공식 요금표 · 유료 Standard · 텍스트)
PRICES = {
# 3.8 Flash 는 2026-12-31 까지 값 (2027-01-01 부터 두 배)
"gemini-3.8-flash": {"in": 0.75, "out": 3.75, "cache": 0.075},
"gemini-3.5-flash-lite": {"in": 0.30, "out": 2.50, "cache": 0.03},
}
def cost_usd(model, u):
p = PRICES[model]
cached = u.cached_content_token_count or 0
output = (u.candidates_token_count or 0) + (u.thoughts_token_count or 0)
return (
(u.prompt_token_count - cached) * p["in"]
+ cached * p["cache"]
+ output * p["out"]
) / 1_000_000
resp = client.models.generate_content(model="gemini-3.8-flash", contents=prompt)
u = resp.usage_metadata
print("tokens:", u.prompt_token_count, u.candidates_token_count, u.thoughts_token_count)
print(f"cost: ${cost_usd('gemini-3.8-flash', u):.6f}")
가짜 서버가 입력 20·답변 60·생각 140토큰을 돌려주게 해서 돌린 출력입니다. 토큰 수는 가짜 값이고, 계산식을 확인하는 용도입니다.
tokens: 20 60 140
cost: $0.000765
답변은 60토큰인데 비용의 대부분(약 69%)이 생각 토큰 140개에서 나왔습니다. candidates_token_count만 보고 비용을 어림하면 이만큼 빗나갑니다. 위 함수는 명시적 캐시의 보관료(3.8 Flash 기준 100만 토큰·1시간당 $0.50)는 넣지 않았습니다. 캐시를 만들어 쓰는 경우는 gemini 컨텍스트 캐싱 글에서 보관료까지 따져 볼 수 있습니다. Interactions API(client.interactions.create)를 쓴다면 응답의 usage에 total_input_tokens·total_output_tokens·total_thought_tokens·total_cached_tokens가 들어옵니다.
5. gemini api 비용 줄이기 — Flex·Batch·모델 고르기
2만 토큰짜리 문서를 앞에 붙이고 질문 100토큰·답변 200토큰을 1,000번 묻는 경우를 계산했습니다(생각 토큰 없음 · 캐싱 안 씀).
| 모델·방식 | 비용 |
|---|---|
| 3.8 Flash Standard (지금) | 약 $15.83 |
| 3.8 Flash Standard (2027년 1월 1일부터) | 약 $31.65 |
| 3.8 Flash Flex 또는 Batch (지금) | 약 $7.91 |
| 3.5 Flash-Lite Standard | 약 $6.53 |
| 4 Argon Standard (지금 → 12월 1일부터) | $42.20 → $84.40 |
같은 조건에 답마다 생각 토큰이 500개씩 붙으면 3.8 Flash Standard가 $17.70으로 올라갑니다. 비용을 줄이는 방법은 세 가지입니다.
- Flex: 요청에
service_tier="flex"만 넣으면 Standard의 50%입니다. 동기 호출 그대로라 코드를 거의 안 바꿔도 되지만, 남는 자원으로 처리하는 방식이라 목표 지연이 1~15분이고 혼잡하면 503·429로 실패합니다. 공식 문서상 이때 Standard로 자동 전환해 주지 않으니 재시도는 직접 짜야 합니다. - Batch API: 역시 50%이고 최대 24시간 안에 처리됩니다. 대량 작업을 한 번에 맡길 때 맞습니다. 쓰는 법은 gemini batch api 사용법 글에 있습니다.
- 모델 고르기: 분류·요약처럼 단순한 일은 Flash-Lite 계열로 내리면 단가가 크게 줄어듭니다. 반대로 Priority(
service_tier="priority")는 Standard보다 75~100% 비쌉니다.
Flex는 대기열에서 기다릴 수 있어서, 공식 문서는 클라이언트 타임아웃을 10분 이상으로 늘리라고 권합니다. SDK의 타임아웃은 밀리초 단위입니다.
from google import genai
client = genai.Client(http_options={"timeout": 900000}) # 15분
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="아래 고객 문의를 배송·환불·교환·기타로 분류해줘.\n...",
service_tier="flex",
)
print(interaction.usage)
자주 묻는 질문 (FAQ)
Q. 충전한 선불 잔액이 다 떨어지면 어떻게 되나요?
공식 결제 문서에 따르면 유료 등급은 선불 잔액이 남아 있을 때만 요청을 처리합니다. 잔액이 바닥나면 AI Studio Projects 페이지의 상태 칸에 No credits가 뜨고, 다시 충전해야 합니다. 사용량은 AI Studio의 Dashboard → Usage에서 볼 수 있습니다.
Q. 검색 그라운딩(Google Search)을 켜면 추가 요금이 있나요?
있습니다. Gemini 3 이상 모델은 모든 모델을 합쳐 월 5,000회까지 무료이고, 그다음은 1,000회당 $14입니다. 요금 문서에 따르면 요청 하나가 검색을 여러 번 일으킬 수 있고 검색 한 번마다 청구됩니다.
Q. ChatGPT·클로드 API와 비교하면 어떤가요?
셋 다 토큰 종량제이고 출력이 입력보다 비싸다는 구조는 같지만, 토크나이저가 달라 같은 글도 토큰 수가 다르게 나옵니다. 단가표만 나란히 놓지 말고 내 프롬프트를 각자 도구로 세어 비교하세요. 다른 두 진영 단가는 chatgpt api 요금 글과 클로드 api 가격 글에 정리해 두었습니다.
마무리
정리하면 Gemini API 비용은 모델 단가 × 토큰 수이고, 생각 토큰도 출력으로 청구됩니다. 토큰은 count_tokens로 미리 세고 usage_metadata로 확인하며, 급하지 않은 일은 Flex나 Batch로 절반에 돌립니다. 특히 Argon과 3.8 Flash는 각각 2026년 12월 1일, 2027년 1월 1일에 단가가 두 배가 되니, 장기 예산은 오른 단가로 잡아 두는 게 안전합니다. 단가는 자주 바뀌므로 결정하기 전에 아래 공식 요금 문서에서 그날 값을 다시 확인하세요.
📚 참고 출처 (2026년 10월 18일 확인 · google-genai 파이썬 SDK 2.31.0)
· Gemini Developer API pricing — Google AI for Developers
· Billing — Gemini API
· Understand and count tokens — Gemini API
· Flex inference — Gemini API

COMMENTS