Gemini 업데이트는 빠른데, 내 코드도 매번 바꿔야 할까? 3.8 Flash까지의 출시 흐름과 코드를 바꿔야 하는 경우
3.5, 3.6, 3.7, 3.8. 구글이 2026년 5월 19일부터 9월 2일까지 네 번이나 내놓은 Gemini Flash 정식 버전 번호입니다. 번호가 바뀔 때마다 코드도 고쳐야 했을까요? 대부분은 아닙니다. 코드를 손봐야 하는 날은 새 모델이 나온 날이 아니라, 쓰던 모델 ID에 종료일이 잡히거나 API 형식이 바뀌는 날입니다. 2025년 11월 Gemini 3 Pro Preview부터 Gemini 3.8 Flash까지 출시 흐름을 따라가며, 언제 코드를 손봐야 하는지 정리합니다.
공개 자료 해설·분석 · 편집: 단단한 아빠 · 작성 기준
- Gemini 3.8 Flash
- Gemini 3 시리즈는 2025년 11월 3 Pro Preview로 시작했습니다. 2026년에는 Flash 정식 버전이 5월(3.5)부터 9월(3.8)까지 네 번 나왔습니다. 9월 30일 발표된 차세대 모델 Gemini 4 Argon은 10월 6일 현재 아직 공개 API로 쓸 수 없습니다.
- Gemini 3.8 Flash는 한 번에 약 100만 토큰을 읽을 수 있습니다. 같은 달에는 지연을 줄인 실시간 음성 모델 3.8 Live도 정식 출시됐습니다.
- 새 모델이 나왔다고 코드를 꼭 바꿀 필요는 없습니다. 쓰던 모델 ID의 지원 종료 일정과 API 변경 사항을 보고 판단하면 됩니다. 다만 정식 모델도 영원하지는 않습니다. 이미지 모델 3.1 Flash Image만 해도 10월 29일 종료될 예정입니다.
Gemini 3 시리즈 출시 타임라인 (2025.11~2026.09)
| 날짜 | 모델·변경 | 무엇이 바뀌었나 |
|---|---|---|
| 2025.11.18 | Gemini 3 Pro Preview | 3 시리즈의 첫 모델 (Preview) |
| 2025.12.17 | Gemini 3 Flash Preview | Flash 계열의 첫 3 시리즈 모델 (Preview) |
| 2026.01.21 | latest 별칭 변경 | gemini-pro-latest·gemini-flash-latest가 3 Preview를 가리키도록 전환 |
| 2026.02.19 | Gemini 3.1 Pro Preview | 커스텀 도구를 우선 처리하는 별도 엔드포인트(-customtools) 추가 |
| 2026.03.03 | Gemini 3.1 Flash-Lite Preview | 3 시리즈 첫 Flash-Lite (5월 7일 정식 출시) |
| 2026.05.19 | Gemini 3.5 Flash (정식) | gemini-flash-latest가 가리키는 모델로 지정 |
| 2026.07.21 | Gemini 3.6 Flash · 3.5 Flash-Lite (정식) | 토큰 효율 개선, 경량 모델 확장 |
| 2026.08.13 | Gemini 3.7 Flash (정식) | 코딩·에이전트 성능 개선 |
| 2026.09.02 | Gemini 3.8 Flash (정식) | 구글이 가장 성능 좋은 Flash 모델로 소개 |
| 2026.09.15 | Gemini 3.8 Live (정식) | 지연을 줄인 실시간 음성 대화(Live API) |
위 표는 구글의 Gemini API 변경 기록(release notes)에서 텍스트 모델과 실시간 음성 대화 모델의 출시만 추렸습니다. 이미지·음악·동영상·음성 합성(TTS) 모델은 따로 나와서 표에서 뺐습니다.
Gemini 3.8 Flash의 특징과 주변 모델
- 긴 입력: Gemini 3.8 Flash의 입력 한도는 1,048,576토큰(약 100만), 출력 한도는 65,536토큰입니다. 텍스트·이미지·동영상·오디오·PDF를 넣으면 텍스트로 답합니다.
- 실시간 음성(Live API): 9월 15일 정식 출시된 Gemini 3.8 Live로는 지연을 줄인 실시간 음성 대화를 할 수 있습니다. 대화하는 동안 뒤에서 더 깊게 추론하는 3.8 Live Extended Thinking은 별도 모델입니다.
- Flash 중심의 출시: 변경 기록을 보면 2026년에 정식 출시된 텍스트 모델은 모두 Flash와 Flash-Lite 계열입니다. 공개 API에서 Pro 계열은 10월 6일 현재도 2월에 나온 3.1 Pro Preview에 머물러 있습니다. 구글은 9월 30일 차세대 모델 Gemini 4 Argon을 발표했지만, 지금은 보안 협력 프로그램 페어윈드(Fairwind)에 참여한 일부 기관을 비롯해 골라 뽑은 초기 이용자만 쓸 수 있습니다. 유료 API 고객과 Google AI Ultra 구독자가 다음 순서라고 했지만 날짜는 밝히지 않았습니다. 자세한 내용은 Gemini 4 Argon 해설에 정리했습니다.
- 이미지 생성·편집: Gemini 3.1 Flash Image와 3 Pro Image는 5월 28일 정식 출시된 이미지 모델입니다. 3.1 Flash Image는 동영상을 넣으면 썸네일이나 포스터 같은 이미지를 만들어 주지만, 결과물은 어디까지나 이미지입니다. 동영상을 만드는 일은 Veo, Gemini Omni Flash 같은 별도 모델 몫입니다. 10월 6일 구글은 3.1 Flash Image의 후속인 Nano Banana 2.1(gemini-nano-banana-2.1)을 정식 출시하고, 3.1 Flash Image를 10월 29일 종료한다고 공지했습니다.
코드를 바꿔야 하는 순간은 따로 있습니다
점검 순서는 간단합니다. 먼저 설정에 적힌 모델 ID를 정확히 확인하고, latest 별칭을 쓰는지도 보세요. gemini-flash-latest 같은 별칭은 코드를 한 줄도 안 고쳐도 가리키는 모델이 바뀔 수 있습니다. 다음으로 종료 공지와 이전 안내서에서 요청 형식, 도구, 샘플링 설정이 바뀌었는지 살펴보세요. 마지막으로 실제 서비스에 넣기 전에 같은 업무를 맡겨 결과와 비용을 비교해 보세요. 비용은 코드와 상관없이 바뀌기도 합니다. 3.6~3.8 Flash는 2026년 말까지 도입가로 100만 토큰당 입력 $0.75, 출력 $3.75를 받지만, 2027년 1월 1일부터는 $1.50, $7.50으로 두 배가 됩니다.
버전이 이렇게 자주 바뀌면 어떤 모델을 골라야 할지 헷갈리기 쉽습니다. 그래도 새 모델이 나왔다고 쓰던 모델이 바로 멈추지는 않습니다. 구글의 지원 종료(deprecations) 페이지를 보면 10월 6일 현재 정식 모델 3.5·3.6·3.7·3.8 Flash에는 종료일이 잡혀 있지 않습니다. 정식 3.x 텍스트 모델 가운데 종료 예정일이 적힌 것은 3.1 Flash-Lite(가장 이르면 2027년 5월 7일) 하나뿐입니다.
그렇다고 ‘정식 모델이면 안전하다’고 단정할 수는 없습니다. 앞에서 본 이미지 모델 3.1 Flash Image는 정식 출시 약 다섯 달 만에 종료일이 잡혔고, 공지에서 종료까지 주어진 시간은 3주 남짓뿐입니다.
2026년에 실제로 모델 ID를 바꿔야 했던 쪽은 주로 Preview 모델과 오래된 계열이었습니다. Gemini 3 Pro Preview는 3월 9일 종료됐고, 이 모델 ID는 이후 3.1 Pro Preview를 가리키게 됐습니다. 3.1 Flash-Lite Preview는 5월 25일, Gemini 2.0 Flash 계열은 6월 1일에 종료됐습니다.
deprecated도 ‘이미 없어졌다’는 뜻은 아닙니다. 구글 문서에서 deprecation은 ‘더는 지원하지 않으며 곧 종료한다’는 예고이고, 엔드포인트를 실제로 끄는 건 shutdown 단계입니다. 7월 21일 변경 기록은 샘플링 파라미터 temperature·top_p·top_k를 deprecated로 표시했고, 3.8 Flash로 옮기는 안내서는 이 값을 설정에서 빼라고 권합니다. 다만 지금 쓰는 모델에서 이 값을 언제부터 무시하거나 거부할지는 변경 기록에 나와 있지 않습니다.
접근 제한도 종료와는 다릅니다. 구글은 9월 18일부터 2.5 모델을 그동안 활발히 써 온 사용자에게만 열어 두었습니다. 그래도 이 모델들은 deprecated가 아니며, 따로 공지할 때까지 API로 계속 제공한다고 밝혔습니다. 대신 새 프로젝트에는 3.5 Flash-Lite나 3.8 Flash를 쓰라고 권했습니다.
“입력 100만 토큰”은 모델이 한 번에 읽을 수 있는 분량을 말합니다. 대략 책 몇 권 분량입니다. 그렇다고 많이 넣을수록 다 잘 알아듣는 건 아니라서, 필요한 자료만 골라 넣는 편이 여전히 낫습니다.
앱 업데이트와 앱 지원 종료는 다릅니다
앱 업데이트 알림이 뜰 때마다 사용법을 새로 익히지는 않습니다. 정말 곤란한 건 쓰던 앱의 지원이 끝난다는 공지가 떴을 때입니다.
Gemini API도 마찬가지입니다. 새 모델 출시는 선택지가 하나 늘었을 뿐이고, 코드를 꼭 손봐야 하는 때는 쓰던 모델 ID에 종료일이 잡히거나 API 형식이 바뀔 때입니다.
새 기능을 빨리 써 보고 싶다면 새 모델을 따로 시험해 보고, 한번 만들어 놓고 오래 굴려야 한다면 Preview 대신 정식 모델 ID를 고정해 두는 편이 관리하기 쉽습니다.
(3.5 → 3.8)
입력 토큰 한도
(10월 6일 기준)
코드를 손봐야 하는 날은 새 모델이 나온 날이 아니라, 쓰던 모델 ID에 종료일이 잡히거나 API 형식이 바뀌는 날입니다.
본문 중에서도입 전에 따져 볼 점
- 출시가 빠르다고 늘 반가운 것은 아닙니다. 서비스를 실제로 운영하는 쪽에서는 새 기능보다 모델의 안정성과 하위 호환이 더 중요할 때가 많습니다.
- Gemini 3.8 Flash의 강점은 긴 입력(약 100만 토큰)과, 여러 형식의 자료를 한꺼번에 받는다는 점입니다. 다만 이 블로그가 비교한 Terminal-Bench 4.0과 FrontierCode 1.1 점수에서는 Claude Fable 5.1과 GPT-6 Astra보다 낮았습니다.
- 모델 ID를 코드 곳곳에 흩어 두지 말고 설정 한곳에 모아 두면, 종료 공지가 왔을 때 바꿀 곳을 바로 찾을 수 있습니다. 공지에서 종료까지 시간이 짧을 수도 있으니 변경 기록과 지원 종료 페이지를 주기적으로 들여다보세요.
- 같은 모델이라도 어디서 쓰느냐에 따라 조건이 다릅니다. 개인 개발자는 Google AI Studio의 무료 등급으로 시작할 수 있지만, 무료 등급에서 보낸 내용은 구글의 제품 개선에 쓰입니다. 기업은 Vertex AI의 후속인 Gemini Enterprise Agent Platform에서 보안·규정 준수 기능을 더해 쓸 수 있습니다.
검증 노트: 9월 25일 수정과 10월 6일 업데이트
- 이전 판은 Gemini 3 시리즈가 2026년 1월 3.0 Flash Preview로 시작했다고 적었습니다. 변경 기록 기준으로 3 Pro Preview는 2025년 11월 18일, 3 Flash Preview는 12월 17일에 나왔고, 2026년 1월 21일에는 latest 별칭만 바뀌었습니다. “2.5 Pro에서 시작했다”는 도입부도 고쳤습니다.
- 이전 판의 “9개월에 주요 버전 6번”과 “그만큼 자주 갈아타야 했다”는 Pro·Flash·Flash-Lite·Live를 한 제품처럼 이어 세고, 출시 횟수를 꼭 옮겨 가야 하는 횟수처럼 설명한 표현이라 고쳤습니다.
- 이전 판은 이미지 모델을 “이미지/동영상 생성”으로 묶었습니다. 3.1 Flash Image의 동영상은 입력이고, 결과물은 이미지입니다.
- temperature·top_p·top_k는 7월 21일 deprecated로 표시됐지만 종료 날짜는 공지되지 않았습니다. “쓰던 설정이 없어졌다”는 표현을 고쳤습니다.
- “지연 없는 음성 대화”를 “지연을 줄인 실시간 음성 대화”로 고쳤습니다.
- 10월 6일 업데이트: 지원 종료 일정과 가격을 다시 확인했습니다. 3.1 Flash Image의 10월 29일 종료 공지, 9월 30일 발표된 Gemini 4 Argon의 제공 범위, 3.6~3.8 Flash의 2027년 가격 인상을 반영했습니다.


