1. 10월 8일 릴리스 노트에 실린 변경
Google은 2026년 10월 8일 Gemini API 공식 릴리스 노트에 모델 2종의 폐기와 Deep Research 에이전트 1종의 종료 일정을 올렸습니다. gemini-3.7-flash는 gemini-3.8-flash로, gemini-3.5-flash는 gemini-3.6-flash로 교체되었고, deep-research-pro-preview-12-2025 에이전트는 2026년 10월 23일 종료됩니다. 수업 예제나 사내 도구 코드에 이 이름이 적혀 있다면 고쳐야 합니다.
변경마다 급한 정도가 다릅니다. Flash 모델은 지금 호출해도 응답이 오지만, Deep Research 에이전트는 종료일이 정해져 있습니다. 요금이나 지역 조건의 변경은 이 릴리스 노트 항목에 언급되어 있지 않습니다.
2. Flash 모델은 자동 연결되지만 이름은 바꿔야 합니다
릴리스 노트에 따르면 gemini-3.7-flash로 보내는 요청은 모두 gemini-3.8-flash로, gemini-3.5-flash로 보내는 요청은 모두 gemini-3.6-flash로 자동 연결됩니다. 코드를 고치지 않아도 호출이 바로 실패하지는 않습니다. Google은 모델 문자열을 gemini-3.8-flash로 바꾸고 Gemini 3.8 Flash 가이드를 확인하라고 안내했습니다.
작성자는 이름을 그대로 두는 쪽이 더 위험하다고 봅니다. 코드에는 3.7이라고 적혀 있는데 실제로는 3.8이 답하므로, 결과가 달라졌을 때 원인을 찾기 어렵습니다. 수업 자료라면 화면에 보이는 모델 이름과 실제로 답한 모델이 다른 상태가 됩니다.
자동 연결이 언제까지 유지되는지는 이 릴리스 노트 항목에 적혀 있지 않습니다. 모델별 폐기·종료 일정은 공식 Deprecations 페이지에 모여 있으니 함께 확인하십시오.
3. Deep Research 에이전트는 10월 23일 전에 바꿉니다
deep-research-pro-preview-12-2025 에이전트는 폐기되었고 2026년 10월 23일 종료됩니다. 릴리스 노트는 새 버전 2종으로 옮기라고 안내합니다. deep-research-preview-04-2026은 속도와 효율에 맞춰 설계되어 결과를 클라이언트 화면에 스트리밍으로 보여 주는 용도에 맞고, deep-research-max-preview-04-2026은 자동으로 자료를 모으고 종합하는 작업에서 포괄성을 최대로 높인 버전이라고 설명합니다.
옮기는 방법도 릴리스 노트에 있습니다. interactions.create 요청의 agent 파라미터 값을 deep-research-pro-preview-12-2025에서 deep-research-preview-04-2026 또는 deep-research-max-preview-04-2026으로 바꾸면 됩니다. 종료일 이후 옛 이름으로 호출하면 어떤 오류가 나는지는 이 항목에 적혀 있지 않습니다. 새 버전 이름에도 preview가 들어 있다는 점은 알아 두십시오.
둘 중 무엇을 고를지는 쓰임새로 정하면 됩니다. 작성자 판단으로는 수업 시연처럼 사람이 화면에서 진행을 지켜보는 경우에는 스트리밍에 맞춘 deep-research-preview-04-2026이, 사람이 지켜보지 않는 자료 조사 작업에는 deep-research-max-preview-04-2026이 공식 설명에 더 가깝습니다. 비용과 소요 시간 차이는 이 항목에 없으므로 같은 질문으로 둘 다 실행해 보고 정하십시오.
4. 수업 자료와 사내 도구에서 이름 찾기
모델 이름은 예제 코드 외에도 실습 노트북, 사내 도구의 설정 파일과 환경 변수, 교안 슬라이드에 넣은 코드 화면에 들어 있을 수 있습니다.
예시로, 소스 폴더에서 grep -rn -e gemini-3.7-flash -e gemini-3.5-flash -e deep-research-pro-preview-12-2025 . 처럼 검색하면 바꿀 줄을 한 번에 찾을 수 있습니다. 앞부분이 같은 다른 모델 이름도 함께 검색될 수 있으니, 검색된 이름이 이번 공지의 이름과 글자 그대로 같은지 확인하십시오.
| 지금 쓰는 이름 | 바꿀 이름 | 릴리스 노트 내용 |
|---|---|---|
| gemini-3.7-flash | gemini-3.8-flash | 폐기, 요청은 gemini-3.8-flash로 자동 연결 |
| gemini-3.5-flash | gemini-3.6-flash | 폐기, 요청은 gemini-3.6-flash로 자동 연결 |
| deep-research-pro-preview-12-2025 | deep-research-preview-04-2026 또는 deep-research-max-preview-04-2026 | 폐기, 2026년 10월 23일 종료 |
5. 이번 주에 할 일
이번 주에는 Deep Research 에이전트부터 바꾸십시오. 위 검색으로 deep-research-pro-preview-12-2025가 들어간 곳을 찾고, 새 이름으로 바꾼 뒤 평소 쓰던 질문 1건으로 실행해 결과가 나오는지 확인하면 됩니다. 10월 23일까지 2주가 채 남지 않았습니다.
Flash 모델 이름은 그다음에 바꿉니다. 이름을 바꾼 뒤 자주 쓰는 요청 몇 건을 실행해, 출력 형식이 코드에서 기대하는 형식과 맞는지 확인하십시오. 교안이라면 화면에 보이는 모델 이름까지 함께 고쳐야 수강생이 따라 입력할 때 헷갈리지 않습니다.