종료 일정과 지금 당장 해야 할 것

결론부터 말씀드리면, gemini-3-pro-preview 엔드포인트는 2026년 3월 9일부로 완전히 꺼졌습니다. 이 모델 문자열로 API를 호출하면 지금 즉시 에러가 반환됩니다. Google이 공식 deprecation 문서에서 지정한 대체 모델은 gemini-3.1-pro-preview입니다. (출처: Google Gemini API Deprecations 공식 문서, 2026.03.11 기준)

코드에서 고정 모델명을 쓰고 있다면 문자열 교체 한 줄로 해결됩니다. 문제는 저장된 프롬프트나 AI Studio에서 꺼내 쓰는 세션입니다. 이쪽은 자동으로 마이그레이션이 안 되고, 직접 열어서 모델을 다시 선택해야 합니다. API 키나 프로젝트 자체는 사라지지 않으니 데이터 손실 걱정은 불필요합니다.

아래는 공식 문서에서 확인한 Gemini 3 계열 모델의 현재 상태입니다.

(출처: Google Gemini API Deprecations, 2026.03.11 기준)

⚠️ 3월 31일 추가 종료 예정: gemini-2.5-flash-lite-preview-09-2025도 곧 닫힙니다. 이 모델을 아직 쓰고 있다면 지금 바로 확인이 필요합니다.

▲ 목차로 돌아가기

14일 예고 원칙을 Google이 직접 어긴 경위

Google은 공식 모델 문서에 “프리뷰 모델은 종료 최소 2주 전에 예고한다”고 명시해 놨습니다. (출처: Google AI Developers – Models 페이지) 그런데 Gemini 3 Pro Preview 종료 공지는 2026년 2월 26일에 올라왔고, 실제 종료는 3월 9일이었습니다. 14일을 세면 3월 12일이어야 합니다. 실제 예고 기간은 11일, 정책보다 3일 짧았습니다.

이 점을 공식 포럼에서 직접 지적한 개발자가 있었고, Google 직원이 답변을 남겼습니다. 하지만 종료 일정은 그대로 3월 9일로 유지됐습니다. 정책을 준수해달라는 요청은 사실상 무시된 셈입니다. (출처: Google AI Developer Forum 마이그레이션 공지, 2026.02.26)

이 사건이 개발자 입장에서 중요한 이유가 있습니다. 많은 프로덕션 파이프라인이 배포 사이클을 2주 기준으로 잡습니다. 스프린트가 2주인 팀이라면 이번 공지를 받자마자 코드 변경을 시작해도 검증 시간이 없는 구조였습니다. 실제로 포럼에는 “3.1 Pro를 마이그레이션했는데 타임아웃 에러가 계속 나서 릴리즈가 막혔다”는 Android 앱 개발자의 글이 올라왔습니다.

▲ 목차로 돌아가기

3.1 Pro가 두 배 강해진 부분과 그 반대인 부분

Google이 내세운 수치는 명확합니다. ARC-AGI-2(완전히 새로운 논리 패턴을 푸는 능력을 측정하는 벤치마크)에서 Gemini 3.1 Pro는 77.1%를 기록했습니다. 3 Pro의 점수는 31.1%였습니다. 2.5배 차이입니다. GPQA Diamond(대학원 수준 과학 문제)에서도 3.1 Pro는 94.1%, 3 Pro는 91.9%로 앞섭니다. (출처: Google 공식 블로그 – Gemini 3.1 Pro 발표, 2026.02.19)

벤치마크만 보면 교체는 당연한 수순처럼 보입니다. 그런데 같은 날 개발자 커뮤니티에서는 EQ-Bench(감정 지능·창작 품질 측정 벤치마크)와 창작 글쓰기 품질에서 회귀가 보인다는 보고가 동시에 올라왔습니다. Reddit r/Bard에 올라온 스레드에는 157개의 추천을 받은 글이 있었고, 실제 사용자들의 반응이 구체적이었습니다.

이 두 가지가 동시에 사실일 수 있는 이유는 벤치마크가 측정하는 영역과 실제 사용 목적이 다르기 때문입니다. 코딩 에이전트나 데이터 분석 파이프라인을 돌리는 개발자에게 3.1 Pro로의 전환은 명백한 업그레이드입니다. 반면 장편 소설 초안, 롤플레이, 시나리오 작업을 하는 사람에게는 체감이 달라집니다. 어떤 목적으로 쓰느냐에 따라 판단이 완전히 바뀝니다.

(ARC-AGI-2, GPQA 출처: Google 공식 블로그 2026.02.19 / EQ-Bench·창작·일본어 항목: Google AI Developer Forum 사용자 보고, 2026.02~03)

▲ 목차로 돌아가기

-latest 앨리어스가 먼저 바뀌었던 이유

이번 종료에서 실제로 트러블을 일으킨 지점이 하나 더 있습니다. Google은 모델 엔드포인트를 고정 문자열 외에 “앨리어스(alias)”로도 제공합니다. gemini-pro-latest라고 쓰면 자동으로 최신 Pro 모델로 라우팅되는 방식입니다.

이번 일정에서 앨리어스 전환은 3월 6일, 실제 엔드포인트 종료는 3월 9일이었습니다. 고정 모델명을 쓰던 팀은 3월 9일까지는 기존 동작을 유지했지만, 앨리어스를 쓰던 팀은 3월 6일부터 이미 3.1 Pro로 넘어간 상태가 됐습니다. 코드에서 어떤 방식으로 모델을 호출하느냐에 따라 실질적인 전환 시점이 3일 달라진 것입니다. (출처: Google AI Developer Forum 마이그레이션 공지)

앨리어스를 쓰는 방식은 매번 모델 문자열을 업데이트하지 않아도 된다는 편의성이 있지만, 이번처럼 주요 모델 교체가 있을 때 사전 테스트 없이 동작이 바뀔 수 있다는 리스크가 함께 따라옵니다. 프로덕션 환경이라면 앨리어스보다 고정 버전 문자열을 쓰고 업데이트를 능동적으로 관리하는 쪽이 더 안정적입니다.

▲ 목차로 돌아가기

Firebase Studio 사용자에게 찾아온 사각지대

이번 종료에서 가장 예상치 못한 피해 사례는 Firebase Studio 사용자들에게서 나왔습니다. Reddit r/Firebase에 올라온 글에는 “4개월 분량의 개발이 멈췄고 복구가 불가능할 수도 있다”는 내용이 담겼습니다. 핵심 문제는 Firebase Studio에서 3월 13일 기준으로도 Gemini 3 Pro Preview를 UI에서 완전히 제거하지 못했다는 것입니다. 종료 공지도 제대로 전달되지 않았고, 모델은 이미 종료됐지만 인터페이스에는 그대로 노출돼 있었습니다. (출처: Reddit r/Firebase, 2026.03.13)

이 케이스는 API를 직접 쓰지 않는 Firebase Studio 통합 환경에서도 모델 종료의 영향권이 미친다는 것을 보여줍니다. Gemini API를 백엔드로 쓰는 모든 Google 서비스에서 비슷한 상황이 생길 수 있습니다. 자신이 사용하는 도구가 어떤 모델 버전에 묶여 있는지 직접 확인해야 하는 이유가 여기 있습니다.

▲ 목차로 돌아가기

앞으로 종료 예정인 모델 일정표

Gemini 3 Pro Preview 종료는 끝이 아닙니다. 공식 deprecations 문서에는 이미 다음 종료 일정이 올라와 있습니다. 가장 가까운 것이 이달 말인 2026년 3월 31일입니다. gemini-2.5-flash-lite-preview-09-2025가 종료됩니다. 이 모델은 특정 단순 작업에서 환각이 적다는 이유로 일부 개발자들이 선호해왔는데, 공식 포럼에서도 대체 모델인 Gemini 3 Flash에서 환각이 90%가량 발생한다는 사용자 보고가 있을 만큼 대체 모델 선택이 간단하지 않습니다.

더 나중 일정으로는 gemini-2.0-flash, gemini-2.0-flash-lite가 2026년 6월 1일에 종료 예정입니다. GA(정식 출시) 모델도 예외가 없습니다. gemini-2.5-pro와 gemini-2.5-flash는 출시 1년 후인 2026년 6월 17일에 종료됩니다. (출처: Google Gemini API Deprecations 공식 문서)

이 일정이 의미하는 건 하나입니다. 지금 어떤 모델을 쓰고 있든 6개월~1년 안에 업데이트가 필요합니다. 모델 문자열을 환경변수나 설정 파일로 관리하지 않고 코드에 하드코딩해 둔 구조라면, 지금이 그 구조를 바꿀 타이밍입니다.

▲ 목차로 돌아가기

자주 묻는 질문 (Q&A)

▲ 목차로 돌아가기

마치며

Gemini 3 Pro Preview 종료는 사전 예고가 짧았고, Firebase Studio처럼 간접 통합 환경에서는 공지조차 제대로 안 갔습니다. 3.1 Pro가 벤치마크 수치에서 확실히 앞서는 건 사실입니다. ARC-AGI-2에서 77.1% 대 31.1%라는 수치는 논리 추론에서의 차이가 분명합니다. 하지만 그 수치가 모든 사용 목적에 동일하게 유효하지는 않습니다.

솔직히 말하면, 이번 종료에서 Google이 자기 정책(14일 예고)을 스스로 지키지 않은 점은 개발자 신뢰 측면에서 아쉬웠습니다. 앞으로 6월에 2.0 계열과 2.5 계열 GA 모델이 연달아 종료됩니다. 지금부터 모델 버전을 코드와 분리해 관리하고, 공식 deprecations 문서를 정기적으로 확인하는 것이 가장 현실적인 대응입니다.

작성 기준: 2026.03.21 / Gemini API 기준

본 포스팅 참고 자료

1. Google Gemini API Deprecations 공식 문서 — ai.google.dev/gemini-api/docs/deprecations
2. Google AI Developer Forum – Gemini 3 Pro Preview 마이그레이션 공지 — discuss.ai.google.dev
3. Google 공식 블로그 – Gemini 3.1 Pro 발표 (2026.02.19) — blog.google
4. Google Gemini API Release Notes — ai.google.dev/gemini-api/docs/changelog