Gemini 3.5 Flash 비권장화: gemini-3.6-flash로의 자동 라우팅 및 마이그레이션 절차

Google AI의 changelog에 'Gemini 3.5 Flash deprecation'가 추가되어, gemini-3.5-flash가 비권장 모델이 되었습니다. 후속 모델은 gemini-3.6-flash입니다.

gemini-3.5-flash로의 요청은 모두 gemini-3.6-flash로 자동 라우팅됩니다. 따라서 기존 코드가 즉시 오류로 멈추지는 않습니다.

다만, 실제 응답하는 모델이 바뀝니다. 코드를 한 줄도 변경하지 않아도 출력 내용, 품질, 동작 방식이 변할 수 있습니다. '작동하니까 방치'가 가장 위험한 유형의 변경입니다.

📌 영향을 받는 사람

• Gemini API에서 모델 문자열에 gemini-3.5-flash를 직접 작성(hardcode)하는 사람
• 출력 포맷이나 문체에 의존하여 후처리 로직(정규표현식, JSON 파싱 등)을 구현한 사람
• 프롬프트 평가 결과나 벤치마크를 고정적으로 운영하는 사람
• CLAUDE.md나 사내 문서에 모델 목록을 기재하는 사람

⚠️ Breaking Change

오류가 발생하지는 않지만, 응답 모델이 암묵적으로 대체되기 때문에 출력 내용, 품질, 동작 방식이 변할 수 있습니다. API가 다운되는 변경보다 인지하기 어려운 점이 문제입니다.

changelog의 차분(diff) 정보에는 다음 내용이 기재되어 있지 않습니다.

• 자동 라우팅 시작일 -
• gemini-3.5-flash 엔드포인트의 완전 중단일

즉, '언제까지 유예 기간이 있는지'가 불분명합니다. 기한을 알 수 없으므로, 가능한 한 빨리 명시적인 마이그레이션을 완료하는 것이 안전합니다.

먼저 리포지토리 내의 참조를 검색하세요.

grep -rn 

| 항목 | 평가 |
|---|---|
| 영향 점수 | 40(🟡 확인 필요) |
| ... | 
- 
`gemini-3.5-flash`

은 비권장됩니다. 후속 모델은 `gemini-3.6-flash`입니다.

- 요청은 자동으로 `gemini-3.6-flash`로 라우팅되며, 즉시 중단되지는 않습니다. 다만 응답 모델이 변경되기 때문에 출력, 품질, 동작에 변화가 있을 수 있습니다.
- 자동 라우팅 시작일이나 완전 중단일은 이번 정보만으로는 알 수 없습니다.
- 모델 문자열을 `gemini-3.6-flash` (또는 `gemini-3.8-flash`)로 업데이트하고, 회귀 테스트와 Gemini 3.6 Flash 가이드를 확인하세요. 모델명은 설정에 분리하고, 문서 업데이트도 잊지 마세요.

'중단되지 않는 비권장'이야말로 조용히 동작이 변하는 것입니다. 지금 미리 명시적인 전환을 완료해 두는 것이 좋겠습니다.