제미나이 API 모델 변경 정리: 3.7 플래시 지원 중단과 교체 방법

제미나이 API에서 gemini-3.7-flash는 2026년 10월 8일 지원 중단(deprecated)으로 바뀌었고, 요청은 gemini-3.8-flash로 자동 전달된다. 구글 Gemini API 릴리스 노트는 모델명을 gemini-3.8-flash로 바꾸라고 안내한다. 같은 날 gemini-3.5-flash도 지원 중단돼 gemini-3.6-flash(또는 gemini-3.8-flash)로 자동 전달되기 시작했다. 코드가 지금 당장 멈추는 것은 아니지만, 모델명을 그대로 두면 어떤 모델이 답하는지 코드에서 보이지 않게 된다(2026년 10월 13일 기준).

제미나이 API 모델 변경: 최근 지원 중단 한눈에 보기

지원 중단(deprecation)은 구글이 해당 모델을 더 이상 지원하지 않겠다고 알린 단계이고, 종료(shutdown)는 엔드포인트가 완전히 꺼지는 단계다. 지원 중단 일정 문서에 따르면 표에 적힌 종료일은 가장 이른 가능 날짜이며, 실제 종료일은 사전에 따로 알린다. 아래 표는 10월 6일과 8일에 공지된 항목이다.

기존 모델	교체 모델	종료일	지금 상태
gemini-3.7-flash	gemini-3.8-flash	해당 없음(N/A)	AI Studio에서 선택 불가, API 요청은 자동 전달
gemini-3.5-flash	gemini-3.6-flash 또는 gemini-3.8-flash	해당 없음(N/A)	AI Studio에서 선택 불가, API 요청은 gemini-3.6-flash로 자동 전달
deep-research-pro-preview-12-2025 (에이전트)	deep-research-preview-04-2026 또는 deep-research-max-preview-04-2026	2026년 10월 23일	종료 예정
gemini-3.1-flash-image	gemini-nano-banana-2.1	발표 없음	지원 중단 공지(10월 6일)

이 표에서 날짜가 정해진 것은 Deep Research 에이전트 하나뿐이다. 3.7 플래시와 3.5 플래시는 지원 중단 일정 문서가 "엔드포인트는 종료되지 않고 API 요청을 자동으로 전달한다"고 밝힌 모델이다. gemini-3.1-flash-image는 공지만 있고 종료일이 발표되지 않았다.

제미나이 3.7 플래시 쓰는 코드는 어떻게 되나

gemini-3.7-flash로 보낸 요청은 구글 서버에서 gemini-3.8-flash가 받아 답한다. 릴리스 노트는 두 가지를 함께 밝혔다. AI Studio 모델 선택 목록에서 3.7 플래시가 사라졌고, API 요청은 자동으로 3.8 플래시로 전달된다.

그래서 모델명을 바꾸지 않아도 요청이 실패하지는 않는다. 다만 응답이 3.8 플래시의 결과이므로 3.7 플래시 기준으로 맞춰 둔 프롬프트와 출력 형식이 달라졌는지 한 번 봐야 한다. 구글은 Gemini 3.8 Flash 안내를 함께 읽으라고 안내한다.

모델명 교체는 코드에서 문자열 하나를 바꾸는 일이다. 모델명을 환경 변수나 설정 파일에 한곳으로 모아 두었다면 한 줄이면 끝난다.

1. 코드와 설정 파일에서 gemini-3.7-flash와 gemini-3.5-flash를 검색한다.
2. 3.7은 gemini-3.8-flash로, 3.5는 gemini-3.6-flash 또는 gemini-3.8-flash로 바꾼다.
3. 사용하던 프롬프트 1~2개를 그대로 다시 보내 답의 형식과 길이를 이전 결과와 비교한다.

바꾼 뒤 제대로 반영됐는지 확인하는 방법

generateContent 응답에는 modelVersion 필드가 들어 있고, API 레퍼런스는 이 값을 "응답을 만든 모델 버전"이라고 설명한다. 모델명을 gemini-3.8-flash로 바꾼 배포본에서 요청을 한 건 보내 응답의 modelVersion을 읽고, 이 값이 gemini-3.8-flash인지 로그나 응답 본문에서 본다. 이 필드는 어느 모델이 답했는지 기록하는 자리이므로, 배포 뒤에도 옛 모델명이 설정에 남아 있는지 가리는 데 쓴다.

AI Studio에서 쓰던 프롬프트는 모델 선택 목록에서 3.7 플래시가 사라졌으므로 모델이 3.8 플래시로 지정된 새 대화에서 다시 시험한다.

제미나이 3.8 플래시 가격: 2027년 1월 1일 두 배

모델이 바뀌면 단가가 같이 바뀌는지가 가장 먼저 궁금해진다. Gemini API 가격 문서에서 gemini-3.8-flash의 유료 등급 표준 요금은 100만 토큰당 입력 $0.75, 출력 $3.75(생각 토큰 포함)이고, 이 값은 2026년 12월 31일까지다. 2027년 1월 1일부터는 입력 $1.50, 출력 $7.50이 된다. 같은 문서의 gemini-3.6-flash 표도 표준 요금이 같은 값이다.

배치와 Flex 요금은 표준의 절반이다. 입력 $0.375, 출력 $1.875이고 2027년 1월 1일부터 입력 $0.75, 출력 $3.75가 된다. 무료 등급은 표준 기준으로 입력·출력 모두 무료이며, 무료 등급에서 보낸 내용은 구글이 제품 개선에 쓸 수 있다고 가격 문서에 적혀 있다. 3.7 플래시의 기존 단가는 현재 가격 문서에 따로 나오지 않으므로, 이전 청구서의 단가와 비교하려면 청구서를 직접 본다.

월 사용량이 큰 서비스라면 2027년 1월 비용을 지금 단가의 두 배로 가정해 두는 것이 안전하다. 3.8 플래시가 구글 모델 중 가격 대비 어느 위치인지는 제미나이 4 아르곤 가격 정리의 비교표에서 Claude, GPT 모델과 함께 볼 수 있다.

날짜가 정해진 종료: Deep Research와 음성 모델

모델명 자동 전달과 달리 아래 두 항목은 날짜가 지나면 요청이 실패한다. 해당 모델을 쓰고 있다면 우선순위가 높다.

• Deep Research 에이전트: 릴리스 노트에 따르면 deep-research-pro-preview-12-2025는 2026년 10월 23일에 종료된다. interactions.create 요청의 agent 값을 deep-research-preview-04-2026(속도와 효율, 화면 스트리밍에 적합) 또는 deep-research-max-preview-04-2026(자료 수집과 종합을 가장 폭넓게)으로 바꾼다.
• 음성(TTS) 모델: 지원 중단 일정 문서 기준 gemini-3.1-flash-tts-preview는 2026년 11월 17일에 종료되고, gemini-3.8-flash-tts 또는 gemini-3.8-flash-lite-tts로 옮기도록 안내한다.

자주 하는 실수

• "지원 중단"을 "종료"로 읽고 서비스를 급히 내리는 것. 3.7 플래시와 3.5 플래시는 종료일이 없고 요청이 계속 처리된다.
• 자동 전달되니 확인할 것이 없다고 생각하는 것. 답을 만드는 모델이 바뀌었으므로 답의 형식, 길이, 말투가 기존 결과와 달라졌는지 본다.
• 3.5 플래시 교체 모델을 3.8 플래시로만 생각하는 것. 자동 전달 대상은 gemini-3.6-flash이고, 안내 문구가 gemini-3.8-flash도 선택지로 둔다.
• 2027년 1월 요금 인상을 놓치는 것. 지금 비용 계산은 12월 31일까지의 단가다.

오늘 해 둘 일 세 가지

1. Deep Research 에이전트를 쓰고 있다면 10월 23일 전에 agent 값을 바꾼다. 날짜가 지나면 요청이 실패하는 유일한 항목이다.
2. gemini-3.7-flash와 gemini-3.5-flash 문자열을 검색해 교체하고, 프롬프트 결과 1~2개를 비교한다. 지금은 자동 전달로 동작하지만, 어느 모델이 답하는지 코드에 적혀 있지 않으면 장애 때 원인을 찾기 어렵다.
3. 3.8 플래시 비용을 2027년 1월 단가(입력 $1.50, 출력 $7.50)로 한 번 다시 계산해 둔다.

제미나이 API 모델 자주 묻는 질문

제미나이 2.5 모델도 곧 종료되나

종료 예정이 아니다. 지원 중단 일정 문서는 2.5 모델이 지원 중단이 아니며 별도 공지 전까지 계속 제공된다고 밝혔다. 다만 용량 관리를 위해 과거에 써 본 사용자에게만 접근을 허용하고, 새 프로젝트에는 3.5 플래시 라이트나 3.8 플래시를 쓰라고 안내한다.

새 프로젝트는 어떤 모델로 시작하나

같은 문서가 새 프로젝트에 권장하는 모델은 gemini-3.5-flash-lite와 gemini-3.8-flash다. 모델 목록은 Gemini API 모델 문서에서 볼 수 있다.

무료로도 쓸 수 있나

가격 문서에서 gemini-3.8-flash의 무료 등급은 표준 요청이 무료다. 배치, Flex 요청은 무료 등급에서 제공되지 않는다.