Gemini API 공식 문서 기준
Gemini 3.0 API 종료,
바뀐 건 더 있습니다
2026년 3월 9일, gemini-3-pro-preview가 공식 종료됐습니다. 구글은 별도 알림 없이 3.1 Pro Preview로 자동 전환해 버렸고, 요금표는 그대로인데 운영 현장에선 예상치 못한 문제가 생겼습니다. 게다가 3월 31일, 즉 지금으로부터 3일 뒤에 또 하나의 모델이 조용히 꺼집니다.
무슨 일이 있었나 — 3월 9일의 자동 전환
2026년 3월 9일, 구글은 gemini-3-pro-preview 모델의 API 엔드포인트를 완전히 종료했습니다. 이 모델은 2025년 11월 18일 출시된 이후 약 4개월간 운영됐고, 공식 지원 중단 문서(ai.google.dev/gemini-api/docs/deprecations)에 따르면 권장 대체 모델은 gemini-3.1-pro-preview입니다.
문제는 이게 단순한 “버전 업그레이드 공지”가 아니었다는 점입니다. 구글은 기존 프로젝트에 연결된 gemini-3-pro-preview 호출을 자동으로 3.1 Pro Preview로 전환했습니다. 나무위키에도 이 사실이 기록됐을 정도로 갑작스러운 조치였습니다. API 키를 바꾼 것도, 코드를 수정한 것도 아닌데 어느 날 호출되는 모델이 달라진 셈입니다.
공식 문서(출처: Google AI for Developers 지원 중단 페이지, 최종 업데이트 2026.03.26)를 보면 gemini-3-pro-preview의 종료일은 2026년 3월 9일로 명시돼 있습니다. 예고는 있었지만 한국어권에서 이 사실을 상세히 다룬 글은 거의 없었습니다.
요금은 그대로다 — 그런데 함정이 있습니다
가장 많이 오해하는 부분입니다. “3.1 Pro로 바꿨으니 요금도 올랐겠지”라고 생각하는 게 자연스럽습니다. 그런데 직접 확인해보니 달랐습니다.
구글 AI 개발자 공식 가격 문서(ai.google.dev/gemini-api/docs/pricing)에 따르면, Gemini 3.1 Pro Preview의 기본 단가는 Gemini 3 Pro Preview와 동일합니다.
| 모델 | 입력 (≤200K) | 출력 (≤200K) | 입력 (>200K) |
|---|---|---|---|
| gemini-3-pro-preview 종료 (2026.03.09) |
$2.00 / 1M | $12.00 / 1M | 종료됨 |
| gemini-3.1-pro-preview 현재 권장 |
$2.00 / 1M | $12.00 / 1M | $4.00 / 1M |
| gemini-2.5-pro 안정형 (2026.06.17 종료 예정) |
$1.25 / 1M | $10.00 / 1M | $2.50 / 1M |
(출처: Google AI for Developers 공식 가격 문서, 2026.03.28 기준)
보면 알겠지만 200K 토큰 이하에서는 3.0과 3.1 Pro의 단가가 정확히 같습니다. 그런데 200K 토큰을 초과하는 순간 입력 단가가 $2.00에서 $4.00으로 두 배 뜁니다. 출력은 $12.00에서 $18.00으로 올라갑니다. 긴 문서, 큰 코드베이스, RAG 컨텍스트가 많은 작업을 하고 있다면 이 임계값이 예산을 조용히 흔들 수 있습니다.
반면 추론 깊이가 비슷한 Gemini 2.5 Pro는 입력 $1.25, 출력 $10.00 — 200K 이하 기준으로 3.1 Pro보다 각각 37.5%, 16.7% 저렴합니다. 대체 경로를 전혀 검토하지 않고 3.1 Pro로 자동 전환된 상태를 그냥 두는 것이 항상 최선은 아닙니다.
성능이 더 좋아졌으니 괜찮다? 실제는 달랐습니다
구글 공식 블로그(blog.google/intl/ko-kr/products/gemini-3-1-pro-kr, 2026.02.19)에 따르면 Gemini 3.1 Pro는 ARC-AGI-2 벤치마크에서 77.1%를 기록했고, 이전 3 Pro 대비 두 배 이상 향상된 추론 성능을 달성했습니다. 숫자만 보면 3.1이 압도적으로 좋습니다.
그런데 실사용 현장의 이야기는 달랐습니다. Reddit(r/GoogleGeminiAI, 2026.03.01)에는 “3.1 출시 이후 API에서 503 오류가 매일 발생하고, 몇 시간씩 다운된다”는 불만이 쏟아졌습니다. Gemini 상태 페이지조차 이를 제대로 반영하지 못했다는 제보도 있었습니다. 또 다른 글(r/GeminiAI, 2026.03.02)에서는 “3.0 Pro는 적어도 안정적이었는데, 구글이 다 3.1로 이동하라고 하면서 정작 3.1은 503이 자주 난다”는 내용이 담겼습니다.
벤치마크 성능이 뛰어난 것과 운영 안정성은 다른 문제입니다. 3.0이 종료된 직후 수주간은 특히 503 오류 빈도가 높았고, 이 시기에 3.0을 대체하지 않고 운영 중이었던 서비스들은 예기치 않은 장애를 경험했습니다.
3월 31일, 아직 모르는 사람이 많은 두 번째 종료
Gemini 3.0 Pro API 종료에 묻혀 덜 알려진 사실이 있습니다. 공식 지원 중단 문서(ai.google.dev/gemini-api/docs/deprecations, 최종 업데이트 2026.03.26)를 보면, gemini-2.5-flash-lite-preview-09-2025의 종료일이 2026년 3월 31일로 명시돼 있습니다.
gemini-2.5-flash-lite-preview-09-2025는 2025년 9월에 출시된 경량 프리뷰 모델로, 가격 실험이나 소규모 프로토타이핑에 많이 쓰였습니다. 대체 모델인 gemini-3.1-flash-lite-preview는 입력 $0.25/1M, 출력 $1.50/1M으로 책정돼 있습니다.
이번 Gemini 3.0 Pro API 종료 이슈를 계기로 지원 중단 문서를 한 번 전체적으로 살펴보는 것이 좋습니다. 문서에는 Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0 Flash가 모두 2026년 6월 1일~6월 17일 사이에 종료 예정으로 등재돼 있습니다. 안정형 모델이라고 영원히 운영되는 게 아닙니다.
배치 모드로 비용을 절반 가까이 줄이는 방법
Gemini 3.0에서 3.1 Pro로 전환이 됐든, 직접 마이그레이션을 진행 중이든, 요금 최적화 관점에서 배치 모드는 가장 먼저 확인할 포인트입니다. aifreeapi.com의 2026년 3월 기준 가격 분석을 보면, 주요 텍스트 모델에서 배치 처리 시 표준 단가의 절반 수준이 적용됩니다.
배치 모드는 결과를 실시간으로 받지 않아도 되는 작업에 적합합니다. 야간 데이터 처리, 비동기 요약, 대량 리라이트, 지연 허용 파이프라인이 여기 해당합니다. 반대로 사용자가 즉시 응답을 받아야 하는 챗 인터페이스에는 적합하지 않습니다.
단, 배치 모드를 쓴다고 무조건 이 요금이 나오는 것은 아닙니다. 구글 공식 결제 FAQ에 따르면 API key를 paid 프로젝트에 연결하는 순간 과금 로직이 달라집니다. 무료 등급에서 테스트한 감각을 그대로 운영 예산에 적용하면 실제 청구액과 어긋납니다.
지금 당장 확인해야 할 체크리스트
Gemini 3.0 Pro API 종료 이후 해야 할 조치를 단계별로 정리했습니다. 항목마다 공식 문서 링크를 함께 확인하는 것이 좋습니다.
코드베이스에서
gemini-3-pro-preview 또는 gemini-2.5-flash-lite-preview-09-2025가 남아 있는지 검색. 3월 9일 이후 호출해도 오류 없이 넘어갔다면 구글이 자동 전환한 것 — 어떤 모델로 전환됐는지 로그를 확인해야 합니다.
3일 뒤
gemini-2.5-flash-lite-preview-09-2025가 종료됩니다. 이 모델을 호출하는 곳이 있다면 gemini-3.1-flash-lite-preview로 교체해야 합니다.
3.1 Pro Preview로 이동했을 때 프롬프트가 200K 토큰을 자주 넘는지 확인. 초과하면 입력 단가가 $2.00에서 $4.00으로 뜁니다. 토큰 수 추정 기준: 100 토큰 ≈ 영어 기준 60~80단어 (출처: Google AI 공식 토큰 가이드).
Gemini 2.5 Pro와 Gemini 2.5 Flash, Gemini 2.0 Flash가 모두 2026년 6월 1일~17일 사이에 종료 예정입니다. 지원 중단 문서(ai.google.dev/gemini-api/docs/deprecations)를 북마크해 두고 주기적으로 확인하는 습관이 필요합니다.
Q&A
Q1. 코드를 바꾸지 않았는데 3.0이 3.1로 자동 전환됐다면, 이미 3.1을 쓰고 있는 건가요?
그렇습니다. 구글이 3.0 종료 시 기존 호출을 3.1 Pro Preview로 자동 전환했습니다. 로그에서 어떤 모델이 응답하고 있는지 확인해 보는 것이 좋습니다. 비용 기준이 달라질 수 있기 때문입니다.
Q2. Gemini 3.1 Pro Preview와 3.0 Pro의 API 요금이 같다고 했는데, 왜 더 비싸진 것처럼 느껴지는 경우가 있나요?
200K 토큰 임계값 때문입니다. 기본 단가는 동일하지만 프롬프트 길이가 200K를 넘으면 단가가 두 배로 뜁니다. RAG 컨텍스트, 긴 코드베이스, 대화 이력이 누적된 경우 임계값을 초과하기 쉽습니다.
Q3. 503 오류가 자꾸 발생한다면 어떻게 해야 하나요?
공식 가이드에서는 3.1 Pro Preview가 503을 지속적으로 반환할 경우 더 안정적인 모델로 자동 전환하는 폴백 로직을 구현하라고 안내합니다. Gemini 2.5 Pro는 3.1 Pro보다 단가가 낮고 안정성이 상대적으로 높아 임시 대안으로 고려할 수 있습니다.
Q4. Google AI Studio에서 무료로 테스트했을 때와 실제 API 요금이 다른 이유는 무엇인가요?
AI Studio는 실험 및 테스트용 인터페이스입니다. 구글 공식 결제 FAQ에 따르면 paid API key를 paid 프로젝트에 연결하면 과금 로직이 달라집니다. AI Studio 체험의 요금 감각을 운영 예산에 직접 적용하면 실제 청구액과 어긋날 수 있습니다.
Q5. 앞으로 비슷한 갑작스러운 종료를 미리 알 수 있는 방법이 있나요?
구글 AI 공식 지원 중단 문서(ai.google.dev/gemini-api/docs/deprecations)에 예정된 종료 날짜가 모두 나와 있습니다. 이 페이지는 최종 업데이트 날짜가 명시돼 있어 언제 갱신됐는지도 확인할 수 있습니다. 중요한 모델을 운영 중이라면 월 1회 정도 이 문서를 확인하는 루틴이 필요합니다.
마치며 — 조용히 바뀐 것들을 챙겨야 할 이유
Gemini 3.0 Pro API 종료는 화제가 되지 않았습니다. GPT-5.4 mini 출시나 에이전틱 AI 같은 큰 뉴스에 묻혔고, 한국어로 이 변화를 정리한 글도 거의 없었습니다. 그런데 API를 실제로 운영하고 있다면 이 조용한 변화가 청구서와 서비스 안정성에 직접 영향을 줍니다.
정리하면 세 가지입니다. 첫째, 3월 9일 종료된 gemini-3-pro-preview는 자동으로 3.1 Pro로 전환됐지만 200K 임계값 요금 구조는 다릅니다. 둘째, 3.1 Pro는 성능이 올랐지만 503 안정성 문제가 3월 초에 집중됐습니다. 셋째, 지금으로부터 3일 뒤(3월 31일) 또 하나의 모델이 종료됩니다.
가격도, 성능도 중요하지만 지원 중단 일정을 주기적으로 확인하는 것이 운영 비용과 장애를 줄이는 가장 낮은 비용의 방법입니다. 구글이 공식 문서에 다 적어놨으니, 북마크 하나만 해두면 됩니다.
📚 본 포스팅 참고 자료
- Google AI for Developers — 지원 중단 문서 (최종 업데이트 2026.03.26)
https://ai.google.dev/gemini-api/docs/deprecations?hl=ko - Google AI for Developers — Gemini API 가격 책정 (공식 문서)
https://ai.google.dev/gemini-api/docs/pricing?hl=ko - 구글 공식 블로그 — 제미나이 3.1 프로 발표 (2026.02.19)
https://blog.google/intl/ko-kr/products/gemini-3-1-pro-kr/ - aifreeapi.com — 2026년 3월 Gemini API 토큰 가격 분석 (2026.03.22)
https://www.aifreeapi.com/ko/posts/gemini-api-token-pricing - Google AI for Developers — Gemini API 결제 FAQ
https://ai.google.dev/gemini-api/docs/billing?hl=ko
본 포스팅은 2026년 3월 28일 기준으로 작성됐습니다. 구글 AI API의 요금 정책, 지원 중단 일정, 모델 기능은 업데이트에 따라 달라질 수 있습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 최신 정보는 항상 구글 공식 문서를 통해 직접 확인하시기 바랍니다.
댓글 남기기