Gemini 2.5 Pro 지원 종료: 12월 1일 자동 전환과 대응 방법

12월 2일에도 gemini-2.5-pro 호출은 실패하지 않습니다. 대신 전혀 다른 모델이 응답합니다. Google은 2026년 11월 2일 gemini-2.5-pro와 gemini-2.5-flash를 지원 종료했고, 2026년 12월 1일부터 Gemini Developer API는 이 ID들을 각각 gemini-3.8-flash와 gemini-3.5-flash-lite로 자동 연결합니다. 요금도 대체 모델 기준으로 청구됩니다. 문제는 단순한 모델 교체가 아니라 등급이 바뀌고 호환되지 않는 파라미터가 생긴다는 점입니다. 12월까지 기존 문자열을 그대로 두는 방식은 안전한 마이그레이션이 아닙니다.

Google이 12월 1일에 바꾸는 것

Google은 Gemini Developer API에서 gemini-2.5-pro와 gemini-2.5-flash를 지원 종료했습니다. 두 모델은 Google AI Studio의 선택 목록에서도 사라졌고, 이제 과거에 해당 모델을 사용한 개발자만 API에 접근할 수 있습니다. 2026년 12월 1일부터 요청 자체는 계속 성공하지만, 실제 실행 모델과 청구 요금은 달라집니다.

모델 전환 관계는 Google의 Gemini API 지원 종료 안내에 다음과 같이 정리돼 있습니다.

Google은 두 안정 버전 ID의 자동 전환일을 2026년 12월 1일로 명시하고 있으며, 공지는 2026년 11월 2일자 변경 로그에 올라와 있습니다. Google DeepMind의 Patrick Loeber도 PSA를 통해 이 내용을 공유하며, 복잡한 통합 환경은 마이그레이션 가이드에 따라 수정해야 한다고 경고했습니다.

이번 공지는 Gemini Developer API와 AI Studio에만 해당합니다. Vertex AI는 Gemini 2.5에 대해 별도의 지원 종료 일정을 적용하며, Google Cloud에는 동일한 모델명에 대해 2026년 10월 일정이 안내돼 있습니다. Firebase AI Logic도 자체 지원 모델 목록을 제공합니다. Vertex 사용자는 12월 1일 일정이 모든 서비스에 적용된다고 가정하지 말고 Cloud 콘솔에서 직접 확인해야 합니다.

Google은 9월 18일까지만 해도 2.5가 “지원 종료되지 않는다”고 밝혔지만, 11월 2일 입장을 바꿔 지원 종료를 발표했습니다. 따라서 12월 1일 일정은 확정된 것으로 보고 준비하는 편이 좋습니다. 당시 변경 과정은 변경 로그 기록에서 확인할 수 있습니다.

12월과 1월, 자동 전환된 호출의 비용은 어떻게 달라지나

Gemini 2.5 Pro 트래픽은 12월에 저렴해지지만 1월부터 입력 토큰 비용이 다시 올라갑니다. Gemini 2.5 Flash의 텍스트 트래픽은 전환 이후에도 같은 가격을 유지하고, 오디오 입력은 크게 저렴해집니다. 아래 수치는 모두 Google의 Gemini API 가격표에 기재된 유료 요금제 기준 100만 토큰당 가격이며, 2026년 11월 3일 기준으로 확인한 값입니다. 모델별 자세한 내용은 Gemini 3.8 Flash 가격과 Gemini 3.5 Flash-Lite 글을 참고하세요.

Gemini 3.8 Flash는 프롬프트 길이와 관계없이 단일 가격 구간을 적용합니다. 따라서 200,000토큰을 넘는 긴 컨텍스트 작업에서 비용 절감 폭이 가장 큽니다. 입력 300k 토큰과 출력 4k 토큰을 사용하는 긴 문서 프롬프트라면 Gemini 2.5 Pro에서는 $2.50/$15.00 기준 약 $0.81, 12월 Gemini 3.8 Flash 요금인 $0.75/$3.75 기준 약 $0.24, 1월 요금인 $1.50/$7.50 기준 약 $0.48이 듭니다. 짧은 프롬프트를 주로 사용하면서 입력 비중이 큰 채팅만 1월에 기존 비용과 비슷한 수준으로 돌아갑니다.

Flash 전환은 비교적 단순합니다.

컨텍스트 캐싱, 배치, 우선순위 요청도 같은 흐름을 따릅니다. 텍스트 요금은 유지되고 오디오 요금은 내려갑니다. 다만 예산을 잡을 때 한 가지 변수는 반드시 고려해야 합니다. 사고 토큰은 출력 토큰으로 과금되며, 대체 모델은 긴 작업에서 생성하는 사고 토큰 수가 달라질 수 있습니다. 따라서 출력 토큰 수가 같을 것이라고 가정해서는 안 됩니다. 비용 전망을 확정하기 전에 실제 트래픽의 usage_metadata를 비교하세요.

모델 문자열만 그대로 둬도 코드가 깨지는 이유

자동 전환은 HTTP 200 응답을 유지한 채 내부 실행 모델만 바꿉니다. Gemini 3.x는 Gemini 2.5에서 허용하던 일부 요청 규칙을 더 엄격하게 적용합니다. 따라서 모델명만 바꾸지 않았을 뿐인 코드도 12월 1일 이후 오류를 내거나, 눈치채기 어려운 동작 변화를 일으킬 수 있습니다.

Gemini 3.x에서는 thinking_budget 대신 thinking_level을 사용합니다. Gemini 3.8 Flash는 low, medium, high를 지원하고 minimal은 거부합니다. 반면 Gemini 3.5 Flash-Lite의 기본값은 minimal입니다. 두 필드를 동시에 보내면 HTTP 400이 반환되며, 두 대체 모델에 하나의 minimal 설정을 공통으로 적용하면 3.8 Flash 경로가 깨집니다. Google은 추출, 라우팅, 분류에는 minimal을, 서브에이전트·도구 호출·코드 실행·다단계 추론에는 medium 또는 high를 권장합니다. 도구가 너무 일찍 종료되는 문제를 피하기 위해서입니다.

Gemini 3 마이그레이션 가이드에 따르면 샘플링과 대화 이력 제어 방식도 달라집니다. Gemini 3.x에서는 현재 temperature, top_p, top_k가 무시되며, 향후 세대에서는 HTTP 400을 반환할 예정입니다. candidate_count는 지원되지 않습니다. 마지막으로 비어 있지 않은 턴의 역할이 model인 요청, 즉 Translation:처럼 모델 응답으로 끝내는 전통적인 프리필 방식도 HTTP 400을 반환합니다. Google은 대신 system_instruction과 구조화된 출력을 사용하도록 안내합니다.

함수 호출 검증도 더 엄격해집니다. Gemini 3.x는 thought_signature를 검증하고, 각 FunctionResponse에 일치하는 호출 ID와 이름이 포함돼야 합니다. 시그니처를 누락하거나 시그니처가 포함된 모델 턴을 새로 구성하지 않으면 깔끔한 오류 대신 빈 STOP 응답이나 MISSING_THOUGHT_SIGNATURE 종료가 발생할 수 있습니다. 회귀 테스트도 예외가 발생하지 않았는지만 볼 것이 아니라 실제 응답 텍스트를 검증해야 합니다.

공지 후 몇 시간 안에 실제 사용자들이 바로 이런 문제를 지적했습니다.

Google이 Gemini 2.5의 종료 날짜를 정했습니다. 중요한 건 지원 종료 자체가 아니라 자동 전환입니다. ... 코드에서 404가 발생하지 않습니다. 대신 조용히 다른 모델이 응답하기 시작합니다. — @VarunChopr17597

에이전트가 아직 gemini-2.5-flash를 호출한다면 12월 1일부터 Gemini 3.5 Flash-Lite에서 실행되며, 기본 사고 수준은 minimal이 됩니다. — @MarMarLabs

11월에 끝내야 할 7단계 마이그레이션 체크리스트

가장 안전한 방법은 11월에 모델 ID를 명시적으로 바꾸고 파라미터를 정리한 뒤, 12월에 연결될 대체 모델과 나란히 평가하는 것입니다. 자동 라우터에 맡기는 것은 마이그레이션 전략이 아닙니다.

1. 각 ID와 프리뷰 별칭을 모두 찾습니다. 영향을 받는 두 ID를 코드, 설정 파일, 평가 하네스, 문서에서 검색하되 영향을 받지 않는 Lite 모델은 제외하세요.

grep -rnE 'gemini-2\.5-(pro|flash)([^-]|$)' .

1. ID를 명시적으로 교체합니다. 12월 1일 아침까지 기다리지 말고 브랜치에서 gemini-2.5-pro를 gemini-3.8-flash로, gemini-2.5-flash를 gemini-3.5-flash-lite로 바꾸세요.
2. 사고 설정을 수정합니다. thinking_budget을 thinking_level로 바꾸고 모델별로 값을 지정하세요. 3.8 Flash에서 에이전트를 사용할 때는 medium 또는 high를, Flash-Lite 작업에서는 minimal과 medium/high를 명시적으로 선택해야 합니다. 3.8 Flash에 minimal 설정을 공유해서는 안 됩니다.
3. 기존 파라미터를 제거합니다. 테스트 전에 temperature, top_p, top_k, candidate_count, 프리필된 마지막 모델 턴을 삭제하세요.
4. SDK와 도구 연동을 업데이트합니다. 최신 SDK로 업그레이드하고 thoughtSignature를 포함한 전체 모델 턴을 보존하세요. FunctionResponse에는 호출 ID와 이름을 모두 넣고, 다중 턴 도구 호출을 처음부터 끝까지 다시 테스트해야 합니다.
5. 대체 모델로 기준선을 다시 측정합니다. 실제 운영 프롬프트를 대상으로 품질, 지연 시간, 출력 길이, usage_metadata의 토큰 수를 비교하세요. 모든 작업에서 Flash 모델이 Pro 모델과 같은 스타일을 내놓지는 않습니다.
6. 비용을 두 번 다시 계산합니다. Pro 경로는 12월에 $0.75/$3.75, 1월부터는 $1.50/$7.50을 기준으로 예산을 잡고, Flash 경로의 오디오 및 캐시 항목도 다시 확인하세요.

이미 Gemini 3.x 또는 gemini-2.5-flash-lite를 사용 중인 팀은 이번 마이그레이션을 건너뛰어도 됩니다. 나머지는 11월 30일 전에 6단계까지 끝내야 합니다. 12월 1일에 테스트 스위트가 통과하더라도, 그것은 라우터가 응답하고 있다는 뜻일 뿐 동작이 그대로 보존됐다는 의미는 아닐 수 있습니다.

에이전트를 만드는 팀이라면 도구 호출이 많은 작업에서 사고 수준을 설정하기 전에 Gemini 3.8 Flash 에이전트 작업 가격 분석도 확인하세요.

자주 묻는 질문

Gemini 2.5 Pro는 2026년 12월 1일에 종료되나요?

아닙니다. Google은 Gemini Developer API에서 2026년 12월 1일을 자동 전환일로 안내하고 있습니다. gemini-2.5-pro 요청은 오류를 반환하는 대신 gemini-3.8-flash로 연결됩니다.

자동 전환된 요청에는 기존 요금과 새 요금 중 무엇이 적용되나요?

새 요금입니다. 12월 1일 이후 gemini-2.5-pro로 보낸 요청에는 Gemini 3.8 Flash 요금이 적용되고, gemini-2.5-flash 요청에는 Gemini 3.5 Flash-Lite 요금이 적용됩니다.

자동 전환된다면 코드를 바꿔야 하나요?

네. Gemini 3.x에서는 사고 설정, 샘플링 파라미터, 프리필 턴, 함수 호출 연동 방식이 달라집니다. 코드를 그대로 두면 무시되는 파라미터, HTTP 400 오류, 또는 조용히 달라지는 추론 동작이 발생할 수 있습니다.

12월 1일 일정은 Vertex AI에도 적용되나요?

아닙니다. 12월 1일은 Gemini Developer API에 해당하는 날짜입니다. Google Cloud는 Vertex AI와 Enterprise Agent Platform의 Gemini 2.5에 대해 2026년 10월의 별도 지원 종료 일정을 안내하고 있습니다.

Gemini 2.5 Flash-Lite도 영향을 받나요?

아닙니다. Google은 gemini-2.5-flash-lite가 지원 종료 대상이 아니며 추후 공지가 있을 때까지 계속 이용할 수 있다고 밝혔습니다.

작업별로 어떤 대체 모델을 선택해야 하나요?

작업 특성을 기준으로 선택한 뒤 반드시 평가해야 합니다. Flash 모델이 기존 Pro 모델과 같다고 가정해서는 안 됩니다.

11월 30일 전에 해야 할 일

이번 주에 두 모델 문자열을 바꾸고 사고 설정과 도구 연동을 정리하세요. Gemini 2.5가 아직 응답하는 동안 대체 모델의 새로운 기준선도 확보해야 합니다. 12월의 자동 전환은 서비스 중단을 막아주지만, 동작과 비용을 직접 통제하려면 11월 안에 마이그레이션을 끝내야 합니다.