Gemini 모델 계열과 버전

지금 쓸 수 있는 Gemini 모델군

Gemini는 빠르게 변해. 2026년 중반 기준으로 안정적인 정식 출시 세대는 Gemini 2.5, 미리보기 세대는 Gemini 3.x야. Gemini 2.0은 지원 중단 예정이지만 종료 날짜는 아직 정해지지 않았어. 튜토리얼에서 gemini-pro나 gemini-1.5-flash를 봤다면 2025년 말 이전의 예전 SDK 시절 자료야. 2.5 세대보다 오래된 모델 ID는 역사 자료라고 생각하면 돼.

운영 환경에 실제로 넣을 정식 모델은 세 가지야:

gemini-2.5-pro — 복잡한 추론과 코딩, 긴 컨텍스트에 맞아. 컨텍스트 창은 1M 토큰이고 최대 출력은 약 64K야.
gemini-2.5-flash — 추론을 겸하는 모델로, 운영 트래픽 대부분의 기본 선택이야. 컨텍스트는 1M이야.
gemini-2.5-flash-lite — 가장 작고 가장 저렴해. 컨텍스트는 1M, 출력은 약 8K로 단순한 대량 작업에 어울려.

미리보기 모델은 기능 플래그 뒤에 숨겨서 쓰고, SLA가 걸린 곳에는 넣지 마:

gemini-3.1-pro-preview — 가장 영리한 모델로, 에이전트형 작업에 맞아.
gemini-3-flash-preview — 최전선 성능에 검색과 그라운딩을 더했어.
gemini-3-pro-image-preview — 자체 이미지 생성 모델이야. 아빠가 "Nano Banana Pro 써"라고 할 때 cwkPippa의 image-gen 스킬이 부르는 모델이 바로 이거야.

네 가지 버전 표기

Google의 모델 ID는 네 종류고, 운영 환경에서 보이는 동작도 달라:

Stable — 날짜나 세대에 고정된 버전(gemini-2.5-flash)이야. 동작 형태가 잠겨 있어 테스트와 계약에 쓰기 안전해.
Preview — 미리보기임을 명시한 버전으로 예고 없이 바뀔 수 있어. 평가에는 괜찮지만 SLA에는 위험해.
Latest 별칭 — 자동으로 최신 버전을 가리켜. 편하지만 어느 날 조용히 대상이 바뀌면 파싱이 깨질 수 있어.
Experimental — 수명이 짧고 지원도 없어. 운영 환경에는 절대 쓰지 마.

컨텍스트 창은 전체 토큰 예산이야. 1M 창에는 시스템 지시문, 이전 대화, 첨부 파일, 현재 프롬프트, 모델 답변이 모두 들어가. 긴 출력도 같은 예산을 쓰므로, 대화 기록이 이미 800K를 차지했다면 300K짜리 답변은 만들 수 없어.

Code

모델 선택 경험칙·python

MODEL_POLICY = {
    'default': 'gemini-2.5-flash',           # production 트래픽 대부분
    'cheap_bulk': 'gemini-2.5-flash-lite',   # Pro 보다 12.5x 싸
    'reasoning': 'gemini-2.5-pro',           # 복잡한 코딩, 수학, 긴 context
    'preview': 'gemini-3.1-pro-preview',     # feature flag 뒤에서만
    'image_gen': 'gemini-3-pro-image-preview',
}

def pick_model(needs_reasoning: bool, ctx_tokens: int, behind_flag: bool = False) -> str:
    if behind_flag:
        return MODEL_POLICY['preview']
    if needs_reasoning or ctx_tokens > 200_000:
        return MODEL_POLICY['reasoning']
    if ctx_tokens < 50_000:
        return MODEL_POLICY['cheap_bulk']
    return MODEL_POLICY['default']

피해야 할 패턴·python

# ❌ Legacy. 2025 년 11 월 EOL.
import google.generativeai as genai
genai.configure(api_key='KEY')
model = genai.GenerativeModel('gemini-pro')

# ❌ 테스트랑 계약에 -latest alias 의존하지 마.
model = 'gemini-2.5-flash-latest'

# ✅ family ID 로 pin. model card 가 spec.
model = 'gemini-2.5-flash'

Exercise

가상의 제품 팀을 위한 한 페이지짜리 "Gemini 모델 정책"을 써 봐. (1) 채팅, 일괄 요약, 이미지 생성에 쓸 기본 모델 ID, (2) 기능 플래그 뒤에서 허용할 미리보기 모델과 금지할 모델, (3) Flash에서 Pro로 올리는 규칙을 포함해. 당직 엔지니어가 30초 안에 읽고 알맞은 모델을 고를 수 있을 만큼 짧고 분명하게 써.

지금 쓸 수 있는 Gemini 모델군

네 가지 버전 표기

Code

External links

Exercise

Progress

댓글 0