"우리 서비스 코드에 아직 veo-3.1-generate-preview가 남아 있는데 괜찮을까?", "gemini-3.7-flash로 돌던 배치는 언제 깨질까?" Gemini API를 운영 환경에 붙여 둔 분이라면 10월 하순 일정을 꼭 확인해야 합니다. 구글 Gemini API 문서의 지원 중단(Deprecations) 페이지와 변경 이력(Changelog)에 10월에 종료되거나 자동 전달되는 모델이 여럿 올라와 있습니다.
결론부터 말하면, Veo 3.1 프리뷰 3종과 gemini-omni-flash-preview는 10월 22일, Deep Research 프리뷰 에이전트는 10월 23일 종료 예정입니다. 이 모델들은 종료되면 엔드포인트가 사라지므로 미리 모델 ID를 바꿔야 합니다. 반면 gemini-3.7-flash와 gemini-3.5-flash는 이미 지원이 중단됐지만 요청이 대체 모델로 자동 전달되어 당장 오류는 나지 않습니다.
✅ 이 글에서 얻을 수 있는 것
1. 10월 종료·자동 전달 모델과 대체 모델 ID 매핑표
2. 자동 전달 모델과 완전 종료 모델의 차이
3. 코드에서 바꿔야 할 모델 문자열을 찾는 스크립트
종료·지원 중단 모델 한눈에 보기
| 기존 모델 ID | 상태 | 날짜 | 대체 모델 |
|---|---|---|---|
gemini-3.7-flash |
지원 중단, 자동 전달 | 10월 8일 | gemini-3.8-flash |
gemini-3.5-flash |
지원 중단, 자동 전달 | 10월 8일 | gemini-3.6-flash (자동) |
veo-3.1-generate-preview |
종료 예정 | 10월 22일 | gemini-omni-1.1-flash |
veo-3.1-fast-generate-preview |
종료 예정 | 10월 22일 | gemini-omni-1.1-flash |
veo-3.1-lite-generate-preview |
종료 예정 | 10월 22일 | gemini-omni-1.1-flash |
gemini-omni-flash-preview |
종료 예정 | 10월 22일 | gemini-omni-1.1-flash |
deep-research-pro-preview-12-2025 |
종료 예정 | 10월 23일 | deep-research-preview-04-2026 또는 deep-research-max-preview-04-2026 |
antigravity-preview-05-2026 |
종료 대상 (이미 지남) | 10월 5일 | antigravity-preview-09-2026 |
표의 날짜는 지원 중단 페이지 기준입니다. 이 페이지는 적힌 날짜가 모델이 종료될 수 있는 "가장 이른 날짜"라고 설명합니다. 그날 정확히 막힌다는 뜻은 아니지만, 그날부터는 언제든 막힐 수 있다는 뜻으로 읽는 것이 안전합니다.
"자동 전달"과 "종료"는 다르다
이번 목록에는 성격이 다른 두 종류가 섞여 있습니다.
| 구분 | 해당 모델 | 기존 코드는? | 해야 할 일 |
|---|---|---|---|
| 자동 전달 | gemini-3.7-flash, gemini-3.5-flash |
요청이 대체 모델로 넘어가 계속 동작 | 모델 ID를 직접 바꿔 응답 품질·비용 재확인 |
| 완전 종료 | Veo 3.1 프리뷰 3종, gemini-omni-flash-preview, Deep Research 프리뷰 |
엔드포인트가 사라져 호출 실패 | 종료일 전에 반드시 교체 |
gemini-3.7-flash는 지원 중단 페이지에서 종료일이 "N/A"로 표시됩니다. 요청은 받아 주지만 실제로는 다른 모델이 답하는 상태입니다. 결과가 이전과 같다고 보장할 수 없으니, 자동 전달에 기대기보다 코드에서 직접 바꿔 두고 결과를 한 번 점검하는 편이 낫습니다.
💡
gemini-3.5-flash의 대체 모델은 문서마다 표현이 다릅니다. 지원 중단 페이지는gemini-3.6-flash로 자동 전달한다고 적었고, 변경 이력은 3.6 또는 3.8 Flash로 옮기라고 권합니다. 정리하면 자동으로는 3.6으로 넘어가고, 새로 바꿀 때는 3.6이나 3.8 중에서 고르면 됩니다.
📌 함께 보면 좋은 가이드: 구글 제미나이 API 무료 사용법｜AI 스튜디오 무료 등급 모델별 한도 총정리 — 3.8 Flash로 옮길 때 무료 등급 한도를 함께 확인하세요.
Veo 3.1 프리뷰 → gemini-omni-1.1-flash
영상 생성에 Veo 3.1 프리뷰 모델을 쓰고 있다면 가장 먼저 챙겨야 합니다. veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview 세 가지가 모두 10월 22일 종료 예정이고, 대체 모델은 gemini-omni-1.1-flash입니다.
gemini-omni-1.1-flash는 변경 이력 기준 8월 27일 정식 출시(GA)된 모델로, 영상 생성과 편집을 360p부터 4K까지 지원합니다. 같은 날 종료되는 gemini-omni-flash-preview도 이 모델로 옮기면 됩니다. 변경 이력에는 이 프리뷰가 원래 9월 30일 지원 중단 예정으로 공지돼 있었습니다.
⚠️ Veo 3.1 프리뷰 3종의 10월 22일 종료 일정은 지원 중단 페이지 한 곳에서 확인한 내용이며, 변경 이력에는 해당 공지가 없습니다. 일정이 바뀔 수 있으니 배포 전에 지원 중단 페이지를 다시 확인하세요.
Veo 계열에서 Omni 계열로 바뀌는 것이라 요청 파라미터와 결과물이 그대로 호환된다고 가정하지 않는 것이 좋습니다. 교체 후 짧은 영상 몇 개로 해상도·길이·품질을 먼저 비교해 보세요.
Deep Research 에이전트 → 04-2026 버전
deep-research-pro-preview-12-2025는 10월 23일 종료 예정입니다. 변경 이력은 용도에 따라 두 가지 중 하나로 옮기라고 안내합니다.
| 대체 모델 | 성격 | 이런 작업에 |
|---|---|---|
deep-research-preview-04-2026 |
속도 중심 | 빠르게 여러 건을 조사할 때 |
deep-research-max-preview-04-2026 |
종합 조사 중심 | 깊이 있는 보고서가 필요할 때 |
지원 중단 페이지의 대체 모델 칸에는 deep-research-preview-04-2026만 적혀 있습니다. 기존과 비슷하게 쓰려면 이 모델을, 더 꼼꼼한 결과가 필요하면 max 버전을 고르면 됩니다.
코드에서 바꿀 모델 문자열 찾기
운영 중인 저장소에서 종료 대상 모델 ID가 남아 있는지 먼저 찾아보세요. 아래는 프로젝트 폴더를 훑어 종료·지원 중단 모델 ID가 쓰인 위치와 대체 후보를 출력하는 파이썬 스크립트입니다. 모델 ID 문자열만 검색하므로 SDK 종류와 상관없이 쓸 수 있습니다.
import pathlib
# 2026년 10월 Gemini API 지원 중단 페이지·변경 이력 기준
REPLACEMENTS = {
"veo-3.1-generate-preview": "gemini-omni-1.1-flash", # 10/22 종료 예정
"veo-3.1-fast-generate-preview": "gemini-omni-1.1-flash", # 10/22 종료 예정
"veo-3.1-lite-generate-preview": "gemini-omni-1.1-flash", # 10/22 종료 예정
"gemini-omni-flash-preview": "gemini-omni-1.1-flash", # 10/22 종료 예정
"deep-research-pro-preview-12-2025":
"deep-research-preview-04-2026 (또는 deep-research-max-preview-04-2026)", # 10/23
"antigravity-preview-05-2026": "antigravity-preview-09-2026",
"gemini-3.7-flash": "gemini-3.8-flash", # 자동 전달 중
"gemini-3.5-flash": "gemini-3.6-flash 또는 gemini-3.8-flash", # 자동 전달 중
}
EXTS = {".py", ".js", ".ts", ".json", ".yaml", ".yml", ".toml"}
for path in pathlib.Path(".").rglob("*"):
is_env = path.name.startswith(".env") # .env, .env.local 등
if not (path.suffix in EXTS or is_env) or "node_modules" in path.parts:
continue
try:
lines = path.read_text(encoding="utf-8").splitlines()
except (UnicodeDecodeError, OSError):
continue
for no, line in enumerate(lines, 1):
for old, new in REPLACEMENTS.items():
if old in line:
print(f"{path}:{no} {old} -> {new}")
gemini-3.5-flash를 찾을 때 gemini-3.5-flash-lite 같은 다른 모델 이름도 함께 잡힐 수 있습니다. 출력 결과를 보고 사람이 한 줄씩 확인한 뒤 바꾸세요. 모델 ID를 환경 변수나 설정 파일 한 곳에 모아 두면 다음 교체 때 훨씬 편해집니다.
📌 함께 보면 좋은 가이드: Claude Haiku 5.5 API 가격·마이그레이션｜4.5에서 바꿀 때 400 오류 주의점 — 다른 API의 모델 교체 체크 포인트도 참고할 만합니다.
함께 나온 소식: Gemini 4 Argon 정식 출시
10월 13일에는 Gemini 4 Argon이 모델 ID gemini-4-argon으로 정식 출시(GA)됐습니다. 변경 이력은 가격을 별도 문서에서 확인하라고만 안내하고 있어, 비용을 계산하기 전에 가격 문서를 따로 확인해야 합니다. Argon의 앱 쪽 기능은 제미나이 4 아르곤 공개｜코딩·법률·보안 성능과 사용 시기 정리에 정리돼 있습니다.
전환 체크리스트
- 저장소에서 위 스크립트로 종료 대상 모델 ID를 찾습니다.
- 10월 22일 전에 Veo 3.1 프리뷰 3종과
gemini-omni-flash-preview를gemini-omni-1.1-flash로 바꿉니다. - 10월 23일 전에 Deep Research 에이전트를 04-2026 버전으로 바꿉니다.
- 자동 전달 중인
gemini-3.7-flash,gemini-3.5-flash도 직접 바꾸고 응답을 점검합니다. - 배포 전에 지원 중단 페이지를 한 번 더 열어 날짜가 바뀌지 않았는지 확인합니다.
운영자 코멘트
문서를 정리하면서 가장 조심해야겠다고 느낀 부분은 "자동 전달"이 주는 안심감입니다. 3.7 Flash처럼 요청이 알아서 넘어가는 모델은 오류가 나지 않으니 그대로 두기 쉽지만, 실제로는 다른 모델이 답하고 있는 상태입니다. 반대로 Veo 3.1 프리뷰와 Deep Research 프리뷰는 자동 전달 없이 엔드포인트가 사라지는 쪽이라, 영상 생성이나 조사 자동화를 돌리고 있다면 이번 주 안에 교체 일정을 잡는 편이 좋겠습니다. 프리뷰 모델을 운영 코드에 넣을 때는 처음부터 모델 ID를 설정 파일로 빼 두는 습관이 결국 시간을 아껴 줍니다.
맺음말
- 10월 22일:
veo-3.1프리뷰 3종·gemini-omni-flash-preview종료 예정 →gemini-omni-1.1-flash로 교체. - 10월 23일:
deep-research-pro-preview-12-2025종료 예정 →deep-research-preview-04-2026또는 max 버전으로 교체. - 자동 전달 중:
gemini-3.7-flash→ 3.8 Flash,gemini-3.5-flash→ 3.6 Flash. 오류는 안 나지만 직접 바꿔 두세요.
공식 자료
- Gemini API Deprecations (Google AI for Developers, 2026년 10월 확인)
- Gemini API Changelog (Google AI for Developers, 2026년 10월 확인)
👉 다음에 읽을 글
- 구글 제미나이 API 무료 사용법｜AI 스튜디오 무료 등급 모델별 한도 총정리 — 3.8 Flash로 옮긴 뒤 무료 한도를 확인할 때
- 챗GPT 딥 리서치(Deep Research) 실무 활용법 — 조사 에이전트를 업무에 쓰는 방법이 궁금하다면
