Gemini API의 릴리스 노트가 Google AI Studio 도메인으로 이전되어, 2026년 10월 분 업데이트 내용을 한 번에 확인할 수 있습니다. 본 기사에서는 개발자에게 영향이 큰 severity: high 변경 사항을 중심으로 정리했습니다.
📌 영향을 받는 사용자
- 신규 유료 프로젝트에서
generateContent 계열 API를 사용하는 사람 (데이터 저장 기본값이 변경되었습니다)
gemini-3.7-flash / gemini-3.5-flash / gemini-3.1-flash-image 모델명으로 고정하여 사용하던 경우
- Deep Research 에이전트
deep-research-pro-preview-12-2025를 사용했던 사람 (2026-10-23에 중단됨)
- Computer Use 또는 Gemini 4 Argon 도입을 검토하는 사람
💡 참고 사항
입력 데이터에는 '이미 보고된 것으로 추정되는' 항목이 많습니다. 이는 릴리스 노트 페이지 재구성 과정에서 과거 기록이 차분(差分) 상 삭제 행으로 표시되기 때문입니다. 본 기사는 새로운 뉴스가 아니므로, 10월 분의 점검용 자료로 읽어주시기 바랍니다.
대응 긴급도로 구분하면 다음과 같습니다.
| 날짜 | 종류 | 내용 | 대응 필요 여부 |
|---|
| 2026-10-06 | 신규 기능 + 사용 중단 권고 | gemini-nano-banana-2.1이 GA, gemini-3.1-flash-image는 사용 중단 권고 (중단일 미공개) | ✅ |
| 2026-10-08 | 사용 중단 권고 | gemini-3.7-flash와 gemini-3.5-flash를 사용 중단 권고하고, 후속 모델로 자동 라우팅됨 | ✅ |
| 2026-10-13 | 신규 기능 | gemini-4-argon이 GA가 되었습니다 | - |
| 2026-10-23 | 사용 중단 (중단) | deep-research-pro-preview-12-2025를 중단합니다 | ✅ |
| 2026-10-26 | 파괴적 변경(Breaking Change) | 신규 프로젝트에서 Generate Content API 요청이 기본적으로 저장되도록 설정됨 (store=true) | ✅ |
| 2026-10-30 | 신규 기능 | Computer Use 툴이 GA가 되었습니다 | - |
⚠️ 파괴적 변경 사항 (Breaking Change)
유료 티어의 신규 프로젝트에서는 generateContent / streamGenerateContent / batchGenerateContent 요청이 기본적으로 저장됩니다 (store=true). 이는 Interactions API와 동일하게 취급되었습니다.
-
기존 프로젝트는 현재 설정 그대로 영향을 받지 않습니다.
-
저장을 피하는 방법은 두 가지입니다.
- 요청마다
store=false를 지정합니다.
- Logs and Datasets 대시보드의 Settings 패널에서 Generate Content API 로깅을 비활성화합니다.
-
주의: 개인 정보, 고객 데이터, 사내 기밀을 다루는 경우 컴플라이언스에 직결됩니다. 새로운 프로젝트를 만들 때는 반드시 설정을 확인해 주십시오.
| 구 모델 | 대체 모델 |
|---|
gemini-3.7-flash | gemini-3.8-flash |
gemini-3.5-flash | gemini-3.6-flash (또는 gemini-3.8-flash) |
- 두 모델 모두 Google AI Studio에서는 선택할 수 없게 되었습니다.
- API 요청은 자동으로 후속 모델로 처리됩니다.
오류가 발생하지 않아 인지하기 어려울 수 있다는 점에 유의해 주십시오. 출력 경향이나 비용이 변경될 가능성이 있습니다.
- 대응 방법은 모델명을 수정하고 출력 품질과 비용을 재확인하는 것입니다.
중단일은 이미 지났습니다. deep-research-pro-preview-12-2025를 지정한 채로 처리할 경우, 작동하지 않을 가능성이 있습니다.
| 마이그레이션 대상 | 특징 |
|---|
deep-research-preview-04-2026 | 속도와 효율을 중시. 클라이언트 UI 스트리밍에 적합 |
deep-research-max-preview-04-2026 | 포괄성(網羅性)이 최대 |
interactions.create
의 agent 매개변수를 수정합니다.
gemini-nano-banana-2.1은 Nano Banana 2(gemini-3.1-flash-image)의 업데이트 버전입니다.
- Flash 클래스의 속도와 비용 효율성은 그대로 유지되었습니다.
- 화질, 프롬프트 충실도, 다중 턴에서의 캐릭터 일관성, 문자 묘사가 개선되었습니다.
- 가로/세로 비율(1:4, 4:1, 1:8, 8:1)에 대응합니다. 해상도는 1K / 2K / 4K입니다.
- 이전
gemini-3.1-flash-image는 비권장(deprecated)되었지만, 중단일은 미발표 상태입니다. 미리 마이그레이션하는 것이 안전합니다.
gemini-4-argon은 복잡한 코딩, 에이전트, 수학, 과학 태스크를 위한 최상위 모델입니다. API 변경 사항, 요금, 마이그레이션 방법은 공식 'What's new in Gemini 4 Argon'에 게재되어 있습니다. 참고로, 리리즈 노트 상단에 있던 'Gemini 4 Argon is now available' 배너는 이번에 삭제되었지만, 제공 상황의 변경을 나타내는 설명은 차분(diff) 데이터에 포함되어 있지 않습니다.
Interactions API와 GenerateContent API 모두 GA가 되었습니다. 이 도구는 2026년 6월 24일에 Gemini 3.5 Flash로 퍼블릭 프리뷰로 공개되었습니다. 다음 기능들을 포함합니다:
- 의도(intent)를 가진 간소화된 액션
- 브라우저, 모바일, 데스크톱 환경 대응
- 안전 정책 설정
- 프롬프트 인젝션 탐지
gemini-api CLI (베타, 2026-10-27): AI 코딩 에이전트, 스크립트, CI 파이프라인을 위한 커맨드 라인 클라이언트입니다. 스테이트리스(stateless)하며 의존성이 없습니다. Interactions API를 통해 텍스트 및 미디어 생성, 파일 분석, 관리형 에이전트 실행이 가능합니다.
리리즈 노트 재구성: 페이지가 'Release notes - Gemini API | Google AI Studio'로 다시 만들어졌습니다. 상단에 AI 에이전트를 위한 인덱스로 https://aistudio.google.com/llms.txt와 https://aistudio.google.com/llms-full.txt가 안내되고 있습니다.
| 우선순위 | 할 일 |
|---|
| 🔴 즉시 | Deep Research의 agent 지정 값을 04-2026 계열로 변경 (중단됨) |
| ... | gemini-3.7-flash / 3.5-flash를 사용하는 부분을 파악하여 수정하고 출력 및 비용을 재확인합니다 |
| 🟡 이번 주 내 | 이미지 생성의 기본 모델을 gemini-nano-banana-2.1로 업데이트합니다 |
| 🟢 선택 사항 | Gemini 4 Argon, Computer Use GA, gemini-api CLI를 검증합니다 |
리리즈 노트를 스크레이핑하는 분들께: 페이지 구조가 Markdown 헤딩 형식(# Release notes)으로 바뀌었으며, 이전 네비게이션도 사라졌습니다. 파서 업데이트가 필요합니다. 또한, 새로운 본문은 차분 데이터 중간에서 잘렸기 때문에, 각 항목이 새 페이지에 그대로 남아있는지는 이 데이터만으로는 확인할 수 없습니다. 공식 페이지에서 직접 확인해 주십시오.
아래는 이해를 돕기 위한 예시입니다. 정확한 매개변수 위치나 SDK별 작성 방법은 공식 문서를 확인하십시오.
# Before: 신규 프로젝트에서는 아무것도 지정하지 않아도 store=true로 처리됨
response = client.models.generate_content(
model="gemini-3.8-flash",
...
- model = "gemini-3.7-flash"
+ model = "gemini-3.8-flash"
- model = "gemini-3.5-flash"
...
💡 팁
모델명과 에이전트명은 코드에 직접 작성하지 않고 설정 파일이나 환경 변수로 분리해 두면, 이번과 같은 비권장 대응을 한 곳의 변경으로 처리할 수 있습니다.
가장 우선순위가 높은 2가지 사항입니다. 신규 유료 프로젝트에서 generateContent 계열이 store=true로 설정되는 경우
중단된 Deep Research 에이전트입니다. - Flash 계열의 구형 모델은 자동으로 후속 모델로 대체되므로, 작동하는 것처럼 보여도 출력과 비용이 달라질 수 있습니다.
- Nano Banana 2.1, Gemini 4 Argon, Computer Use의 GA(General Availability)는 마이그레이션 및 검증을 진행할 시점입니다.
- 게재된 내용의 대부분은 과거 업데이트를 포함합니다. 확인할 때는 모델명, 에이전트명, 프로젝트 설정을 한 번 총점검하는 것이 가장 빠릅니다.
