# Gemini 2.5 Pro 지원 중단: 12월 1일에 바뀌는 것

> 12월 1일부터 gemini-2.5-pro 요청은 gemini-3.8-flash로 자동 전환되고 3.8 Flash 요금으로 청구됩니다. 깨지는 곳과 수정 방법.

- Canonical HTML: https://omniakey.com/ko/blog/gemini-2-5-pro-deprecated-migration-guide
- Markdown: https://omniakey.com/ko/blog/gemini-2-5-pro-deprecated-migration-guide.md
- Published: 2026-11-04 (updated 2026-11-04)
- Author: Kiki, COO at OmniaKey
- Language: ko
- Category: Guide
- Reading time: 8 min
- All posts: https://omniakey.com/blog/llms.txt

---

2026년 12월 1일, Google은 [Gemini 2.5 Pro](https://omniakey.com/ko/gemini-2-5-pro) 요청을 모두 [Gemini 3.8 Flash](https://omniakey.com/ko/gemini-3-8-flash)로 보내고 3.8 Flash 요금으로 청구합니다. 100만 입력 token당 $0.75, 100만 출력 token당 $3.75이며 이 요금은 2026년 12월 31일까지입니다(Google 지원 중단 페이지, 2026년 11월 4일 확인). 당일 호출은 계속 성공합니다. 예전 모델에 맞춰 작성한 요청 본문은 실패하지만, 대부분의 수정은 몇 줄이면 끝납니다.

변경 세 가지로 대부분의 작업이 정리됩니다.

- 모델 문자열을 `gemini-3.8-flash`로 바꿉니다.
- `thinking_budget`을 `thinking_level`로 교체합니다.
- `temperature`, `top_p`, `top_k`, `candidate_count`와 미리 채운 model 턴을 삭제합니다.

나머지 세 단계는 멀티턴 상태, 함수 호출, SDK를 다룹니다. 각 단계의 결과와 건너뛰었을 때 보이는 증상을 아래에 적었습니다.

## 12월 1일에 무슨 일이 일어날까요?

날짜의 근거는 카운트다운 페이지가 아니라 Google 릴리스 노트입니다. 2026년 11월 2일자 항목은 `gemini-2.5-pro`를 지원 중단으로 표시하고, 모든 API 요청이 자동으로 `gemini-3.8-flash`로 가며 Gemini 3.8 Flash 요금으로 청구된다고 밝힙니다(Google 릴리스 노트, 2026년 11월 4일 확인).

지원 중단 표는 앞뒤 날짜를 더합니다. 2025년 6월 17일 출시, 2026년 12월 1일 종료, 대체 모델은 `gemini-3.8-flash`입니다(2026년 11월 4일 확인). 모델 페이지는 범위가 더 좁습니다. API는 실제로 사용해 온 기존 사용자에게만 열려 있고, 그마저도 2026년 12월 1일까지입니다. AI Studio 선택 목록에서는 이미 빠졌습니다.

같은 표의 한 행을 두 번 읽어 볼 만합니다. 2026년 12월 1일을 종료일로 적으면서 3.8 Flash로의 자동 전달도 약속합니다. 전달된 호출이 응답에 `gemini-2.5-pro`를 적는지 `gemini-3.8-flash`를 적는지는 Google이 밝히지 않았습니다. 첫날 받은 모델 ID를 로그에 남기십시오.

응답이 무엇을 적든 대체 모델은 안정적입니다. `gemini-3.8-flash`는 2026년 9월 2일에 출시됐고, 안정 버전 ID가 하나이며, 아직 종료일이 공지되지 않았습니다(Google 지원 중단 페이지, 2026년 11월 4일 확인).

## 전환 후 코드와 청구서는 어떻게 달라질까요

기존 사용자 조건은 12월 1일 전인 지금부터 적용됩니다. Google의 2.5 Pro 모델 페이지는 API가 실제로 사용해 온 기존 사용자에게만, 2026년 12월 1일까지 열린다고 밝힙니다(2026년 11월 4일 확인). 나머지 작업을 계획하기 전에 팀이 실제로 배포하는 키로 먼저 시험하십시오.

두 모델은 이 조건이 주는 인상보다 훨씬 비슷합니다. 둘 다 입력 1,048,576 token을 받고 최대 65,536 token을 돌려주며, 텍스트, 이미지, 비디오, 오디오, PDF를 읽고 텍스트를 반환합니다(Google 모델 페이지, 2026년 11월 4일 확인). 차이는 가장자리 기능에서 나옵니다. 3.8 Flash 페이지는 computer use를 지원으로 적고, 2.5 Pro 페이지에는 computer use 행이 없습니다. 오디오 생성, 이미지 생성, Live API는 두 모델 모두 미지원으로 표시됩니다.

다음은 청구서입니다. 12월 1일부터는 같은 요청에 3.8 Flash 요금을 냅니다. 그 전까지 2.5 Pro는 자체 요금과 200,000 token 구간을 유지합니다.

## 3.8 Flash로 옮기면 깨지는 요청

동작이 달라지는 요청 형태는 여섯 가지이며, 함수 호출을 가장 꼼꼼히 봐야 합니다. Google의 3.8 Flash 마이그레이션 체크리스트가 각 변경을 하나씩 적습니다(2026년 11월 4일 확인).

|보내는 내용|일어나는 일|바꿀 것|
|-|-|-|
|`thinking_budget`|3.8 요청에서는 교체됨|`thinking_level`을 보냅니다|
|`thinking_level: "minimal"`|오류가 돌아옵니다|`low`, `medium`, `high` 중 하나|
|`temperature`, `top_p`, `top_k`|지금은 무시되고, 다음 세대에서는 HTTP 400|삭제합니다|
|`candidate_count`|Gemini 3 이후 미지원|호출당 후보 하나|
|마지막 턴이 `role: "model"`|HTTP 400|규칙을 `system_instruction`으로 옮깁니다|
|`call_id`와 `name`이 없는 `FunctionResponse`|`Malformed_Function_Call`|두 필드를 모두 넣습니다|

샘플링 파라미터는 조용한 실패입니다. Google의 3.6 릴리스 노트는 `temperature`, `top_p`, `top_k`가 지원 중단되어 지금은 무시되고, 다음 모델 세대에서는 지정하면 HTTP 400이 돌아온다고 밝힙니다(2026년 11월 4일 확인). 조정해 둔 프롬프트에는 거부보다 무시가 더 나쁩니다. 결정성 설정이 아무 일도 하지 않게 되고, 알려 주는 오류도 없습니다.

요란한 쪽은 프리필입니다. 마지막 비어 있지 않은 턴이 model 턴인 요청은 HTTP 400을 돌려주며, 해법은 `system_instruction`이나 구조화 출력입니다(Google 3.6 릴리스 노트, 2026년 11월 4일 확인). 멀티턴 대화는 마지막 턴을 채운 대화 기록을 다시 만드는 대신 `previous_interaction_id`를 실어야 합니다.

함수 호출에서는 멀티모달 자산을 응답 페이로드 안에 넣고, 인라인 지시 사이를 `\n\n`로 나누고, 도구 앞 텍스트 주변에서 `Malformed_Function_Call`이 나오면 Google이 제시한 우회 방법을 쓰십시오. 기존 `generateContent` 호출에서는 모든 `FunctionResponse`에 `call_id`와 `name`이 필요합니다.

여섯 번째는 thought signature이며, SDK가 모델보다 오래됐을 때 중요합니다. Google 체크리스트는 SDK 업데이트와 signature 보존을 위해 thought signature 페이지로 안내합니다.

## 여섯 가지 변경을 순서대로

이 순서로 진행하십시오. 처음 두 가지는 모든 요청에, 나머지는 특정 기능에 적용됩니다.

1. **모델 문자열을 바꿉니다.** `gemini-2.5-pro` 대신 `gemini-3.8-flash`를 보냅니다. 재시도 함수가 아니라 설정에 적어서, 로그에 의도한 ID가 남게 하십시오.
2. **thinking 예산을 교체합니다.** `thinking_budget`은 `thinking_level`이 되고 값은 `low`, `medium`, `high`입니다. 기본값은 `medium`이고 `minimal`은 오류를 돌려줍니다.
3. **샘플링 파라미터와 프리필 턴을 삭제합니다.** `temperature`, `top_p`, `top_k`, `candidate_count`, 끝에 붙은 model 턴이 모두 빠집니다.
4. **멀티턴 상태를 옮깁니다.** 서버 쪽 `previous_interaction_id`로 통일합니다.
5. **함수 호출을 점검합니다.** 자산은 응답 페이로드 안에, 인라인 지시 사이는 `\n\n`, 모든 `FunctionResponse`에 `call_id`와 `name`을 넣습니다.
6. **SDK를 업데이트하고 thought signature를 유지합니다.** 3.8 체크리스트가 이 작업을 Google의 thought signature 페이지로 연결합니다.

요청 차이는 한 블록에 담깁니다. 변경 전:

```json
{
  "model": "gemini-2.5-pro",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_budget": 8192,
    "temperature": 0.7,
    "top_p": 0.9
  }
}
```

변경 후:

```json
{
  "model": "gemini-3.8-flash",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_level": "medium"
  }
}
```

12월 1일 전에 `gemini-3.8-flash`로 실제 요청을 한 번 보내고, 응답의 모델 ID를 로그에 남기십시오.

전환 기간에 `gemini-3.8-flash`를 다른 방식으로 호출하고 싶다면 [Gemini 3.8 Flash 모델 페이지](https://omniakey.com/ko/gemini-3-8-flash)에 모델 ID, 1M 컨텍스트, 세 가지 thinking 레벨이 있습니다. 두 모델의 현재 요금은 [요금 페이지](https://omniakey.com/ko/pricing)에 있습니다.

## 요금 차이는 얼마일까요

표준 유료 등급에서 2026년 12월 31일까지 3.8 Flash는 출력이 2.5 Pro의 절반 이하이고 입력은 40% 쌉니다(Google 요금 페이지, 2026년 11월 4일 확인).

|모델|입력 100만|출력 100만|
|-|-|-|
|`gemini-2.5-pro`, 20만 이하|$1.25|$10.00|
|`gemini-2.5-pro`, 20만 초과|$2.50|$15.00|
|`gemini-3.8-flash`, 2026년 12월 31일까지|$0.75|$3.75|
|`gemini-3.8-flash`, 2027년 1월 1일부터|$1.50|$7.50|

입력 100,000 token, 출력 20,000 token 요청이면 차이가 분명해집니다. 2.5 Pro에서는 $0.125 + $0.20 = $0.325입니다. 3.8 Flash에서는 2026년 12월 31일까지 $0.075 + $0.075 = $0.15이고, 2027년 1월 1일부터는 $0.15 + $0.15 = $0.30입니다.

축하하기 전에 2027년 행을 읽으십시오. 입력은 2.5 Pro의 $1.25보다 20% 비싸지고, 출력은 2.5 Pro의 $10.00보다 25% 싼 상태로 남습니다. 입력이 대부분인 요청은 내년에 오늘의 2.5 Pro보다 더 비쌉니다.

배치 요금도 모양이 같습니다. 2.5 Pro는 20만 token까지 입력 $0.625, 출력 $5.00을 받고, 3.8 Flash는 2026년 12월 31일까지 $0.375와 $1.875를 받습니다(Google 요금 페이지, 2026년 11월 4일 확인).

캐싱, Priority, 2027년 숫자를 포함한 전체 요금표는 [Gemini 3.8 Flash 요금 가이드](https://omniakey.com/ko/blog/gemini-3-8-flash-api-pricing)에 있습니다.

## 2.5 Flash와 2.5 Flash-Lite

2.5 Flash는 같은 12월 1일이 적용됩니다. 2.5 Flash-Lite는 다릅니다.

|모델|종료일|대체|
|-|-|-|
|`gemini-2.5-flash`|2026년 12월 1일|`gemini-3.5-flash-lite`|
|`gemini-2.5-flash-lite`|공지 없음|계속 제공|

Google 지원 중단 페이지(2026년 11월 4일 확인)는 `gemini-2.5-flash`를 2.5 Pro와 같은 조건에 둡니다. 2025년 6월 17일 출시, 2026년 12월 1일부터 요청은 `gemini-3.5-flash-lite`로 가고 청구는 3.5 Flash-Lite 요금으로 옮겨집니다. `gemini-2.5-flash-lite`는 지원 중단이 아니며 별도 공지가 있을 때까지 제공됩니다.

오디오 ID 두 개는 달력에 따로 적어야 합니다. `gemini-2.5-pro-preview-tts`와 `gemini-2.5-flash-preview-tts`는 2026년 11월 17일에 종료되고 `gemini-3.8-flash-tts` 또는 `gemini-3.8-flash-lite-tts`로 대체됩니다.

더 오래된 고정형 2.5 Pro 프리뷰는 이미 끝났습니다. `gemini-2.5-pro-preview-03-25`, `-05-06`, `-06-05`의 종료일은 2025년 12월 2일이므로, 설정에 이 중 하나가 남아 있다면 오늘 이미 실패하고 있습니다.

## 자주 묻는 질문

### Gemini 2.5 Pro는 지원 중단됐나요?

예. Google의 2026년 11월 2일자 릴리스 노트가 `gemini-2.5-pro`를 지원 중단으로 표시하고, 지원 중단 페이지는 2026년 12월 1일을 모든 API 요청이 `gemini-3.8-flash`로 옮겨 가는 날로 정합니다(2026년 11월 4일 확인). AI Studio 선택 목록에서는 이미 사라졌습니다.

### 2026년 12월 1일에 제 호출은 어떻게 되나요?

답은 계속 돌아옵니다. Google은 `gemini-2.5-pro` 요청이 자동으로 `gemini-3.8-flash`로 가고 3.8 Flash 요금으로 청구된다고 밝힙니다. 같은 표가 2026년 12월 1일을 종료일로도 적고, 응답이 어느 모델 ID를 보고하는지는 밝히지 않습니다. 첫날 로그에 남기십시오.

### Gemini 2.5 Pro를 AI Studio에서 아직 쓸 수 있나요?

아니요. Google은 `gemini-2.5-pro`를 AI Studio 선택 목록에서 제거했고, API는 실제로 사용해 온 기존 사용자에게만 2026년 12월 1일까지 엽니다(Google 지원 중단 페이지와 모델 페이지, 2026년 11월 4일 확인).

### 아무것도 바꾸지 않으면 코드가 깨지나요?

깨집니다. 3.8 Flash가 예전 필드를 거부합니다. `thinking_level: "minimal"`, `candidate_count`, 마지막 model 턴, `call_id`와 `name`이 없는 `FunctionResponse`입니다. `thinking_budget`은 `thinking_level`이 되어야 하고, `temperature`, `top_p`, `top_k`는 이미 무시됩니다. Google 마이그레이션 가이드가 각 변경을 적으며, 마지막 비어 있지 않은 턴이 model 턴인 요청은 지금도 HTTP 400을 돌려줍니다.

### Gemini 3.8 Flash는 얼마나 싼가요?

2026년 12월 31일까지 20만 token 이하에서 입력은 40%, 출력은 62.5% 쌉니다. 100만 token당 $0.75 대 $1.25, $3.75 대 $10.00입니다. 2027년 1월 1일부터는 입력이 2.5 Pro보다 20% 비싸고 출력은 25% 쌉니다.

## 확인한 출처

- [Google Gemini API 지원 중단 정보](https://ai.google.dev/gemini-api/docs/deprecations)
- [Google Gemini API 릴리스 노트](https://ai.google.dev/gemini-api/docs/changelog)
- [Gemini 3.8 Flash로 마이그레이션](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8)
- [Gemini 3.6 API 변경과 파라미터 업데이트](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6)
- [Gemini 2.5 Pro 모델 페이지](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro)
- [Gemini 3.8 Flash 모델 페이지](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash)
- [Gemini API 요금](https://ai.google.dev/gemini-api/docs/pricing)