Gemini Nano Banana 2.1 GA 및 gemini-3.1-flash-image 사용 중단 안내 (마이그레이션 가이드)

2026년 10월 6일, Gemini API의 이미지 생성 및 대화형 편집 모델인 Gemini Nano Banana 2.1 (gemini-nano-banana-2.1)가 일반 제공(GA)되었습니다. Nano Banana 2 (gemini-3.1-flash-image)의 후속작으로, Flash 수준의 속도와 비용 효율성은 유지하면서 품질이 크게 향상되었습니다. 동시에 gemini-3.1-flash-image의 사용 중단과 2026년 10월 29일 제공 종료도 발표되었습니다. 공지부터 종료까지 약 3주밖에 남지 않았습니다.

📌 영향을 받는 사람

• 코드에서 모델 ID gemini-3.1-flash-image를 직접 지정하는 사람
• Gemini API의 이미지 생성 및 이미지 편집 기능을 앱이나 배치 처리(batch processing)에 통합한 사람
• 문서나 샘플 코드, 사내 규칙 (CLAUDE.md 등)에 구형 모델 ID를 작성한 사람

이 글에서는 무엇이 바뀌는지, 언제까지 무엇을 해야 하는지 정리합니다.

Nano Banana 2.1은 이미지 생성 및 대화형 편집을 위한 고효율 모델입니다. Flash 수준의 속도/비용 효율성을 유지하면서 다음 5가지가 개선되었습니다.

• 화질 (画質)
• 프롬프트에 대한 충실도 (忠実さ)
• 여러 턴에 걸친 캐릭터 일관성 (一貫性)
• 문자 묘사 (文字の描画)
• 가로/세로/파노라마의 종횡비(アスペクト比)에서의 생성

⚠️ Breaking Change

제공 종료 후에는 gemini-3.1-flash-image를 지정한 요청은 작동하지 않을 위험이 있습니다. 이미지 생성을 포함하는 배치 처리나 정기 작업(定期ジョブ)도 대상입니다.

| 항목 | gemini-3.1-flash-image | gemini-nano-banana-2.1 |
|---|---|
| 위치 설정 | Nano Banana 2 | Nano Banana 2.1 (후속작) |
| 상태 | 사용 중단 권장 (10/29 종료) | GA |
| 속도/비용 | Flash 수준 | Flash 수준 (동등) |
| 화질/프롬프트 충실도 | 기존 방식 | 향상 |
| 캐릭터 일관성 (여러 턴) | 기존 방식 | 향상 |
| ... |
※ 구형 모델 측의 '—'는 이번 정보에 기재되어 있지 않음을 의미합니다. 구형 모델이 미지원한다는 뜻은 아닙니다.

• 구형 모델 ID 파악: 코드, 설정 파일, 환경 변수, 문서, 샘플을 검색합니다. - 모델 ID 교체: gemini-3.1-flash-image를 gemini-nano-banana-2.1로 대체합니다. - 출력 확인: 출력 품질 외에 종횡비 및 해상도 지정 방식에 차이가 없는지 사전에 확인합니다. 이번 정보에는 구체적인 차이점이 기재되어 있지 않으므로, 공식 Image generation guide에서 확인해 주십시오. - 여유를 두고 출시: 제공 종료 직전이라면 문제가 발견되어도 수정할 시간이 없습니다.

💡 팁

모델 ID는 코드에 직접 작성하지 않고 환경 변수나 설정 파일로 일원화하여 관리하면, 향후 교체가 한 곳의 변경으로 끝납니다.

• EC/광고 제작: 배너나 상품 이미지를 자동 생성하는 경우. 새로운 4:1 / 1:4 등의 비율은 길쭉한 배너 용도와 잘 어울릴 것 같습니다. - 캐릭터/만화/스토리 관련 앱: 여러 턴에 걸쳐 동일 캐릭터를 유지하고 싶을 때, 일관성 향상이 효과적입니다. - 문자 포함 이미지 제작자: 포스터나 썸네일 등에서 문자 묘사가 개선된 점은 품질의 상향 평준화를 가져옵니다. - 파노라마/헤더 이미지: 1:8 / 8:1과 같은 극단적인 가로/세로에도 대응했습니다.

AI 에이전트에게 Gemini를 사용하게 하는 경우, 참조 문서를 업데이트하여 구형 모델 ID가 다시 생성 코드에 섞이는 것을 방지할 수 있습니다.

• 이미지 생성의 권장 모델을 gemini-nano-banana-2.1로 설정합니다.

（GA）로 변경합니다 - 새로운 종횡비(1:4, 4:1, 1:8, 8:1)와 1K/2K/4K 해상도를 지원하는 점을 추가합니다

gemini-3.1-flash-image
을 비권장 처리하고 제공 종료일인 2026-10-29를 명시하며 마이그레이션 대상을 밝힙니다 - 코드 예시에 남아있는 모든 구형 모델 ID를 교체합니다

아래는 모델 ID를 교체하는 방법을 보여주는 이미지입니다. SDK 호출 형식은 사용 중인 버전에 맞춰주세요. 종횡비나 해상도 지정 파라미터의 정확한 작성법은 공식 Image generation guide를 참조해 주세요.

from google import genai
client = genai.Client()
response = client.models.generate_content(
...

import os
from google import genai
client = genai.Client()
...

grep -rn "gemini-3.1-flash-image" .

Gemini Nano Banana 2.1(Flash와 비슷한 속도 및 비용 효율성을 유지하면서 화질, 프롬프트 충실도, 캐릭터 일관성, 문자 묘사가 향상되었습니다. gemini-nano-banana-2.1)
이 GA - 새롭게
1:4, 4:1, 1:8, 8:1의 종횡비를 지원하며, 1K・2K・4K 모든 해상도에서 사용할 수 있게 되었습니다. -
입니다. gemini-3.1-flash-image
은 비권장되며, 2026년 10월 29일에 제공이 종료됩니다 - 대응의 기본은,
모델 ID를 교체하는 것입니다. 아울러 출력 품질과 종횡비・해상도 지정 여부를 확인해 주세요. gemini-nano-banana-2.1
로 대체합니다 - 공지부터 종료까지 약 3주밖에 남지 않았으므로, 먼저
grep
으로 구형 모델 ID 사용 위치를 파악하는 것부터 시작하는 것이 좋습니다.