2026년 11월 12일, Gemini API에 새로운 모델인 Gemini 4 Hydrogen (모델 ID: gemini-4-hydrogen)이 일반 제공(GA)되었습니다. 이 모델은 '최첨단 지능을 모두에게'라는 목표 아래, 일상적인 코딩 및 에이전트 워크플로우에서 속도와 효율성을 중시하여 설계된 모델입니다.
이번 주요 변경 사항은 다음 세 가지입니다.
- 무료 계정으로 사용 가능하며, 유료 계정 요금은 입력 $1.50 / 출력 $7.50 (100만 토큰당)입니다.
- 사고 레벨(thinking level)에 네 번째 단계인
xhigh가 추가되었습니다.
- Gemini Managed Agents의 Antigravity 에이전트 기본 모델이
gemini-4-hydrogen으로 변경되었습니다.
특히 세 번째 항목은, 모델을 명시하지 않고 에이전트를 사용할 경우 작동 방식, 요금, 응답 경향에 변화가 생길 수 있으므로 확인이 필요합니다.
📌 영향을 받는 사용자
- Gemini 3.8 Flash를 사용하는 개발자 (API 변경점 확인 필요)
- 모델 지정 없이 Gemini Managed Agents의 Antigravity 에이전트를 사용하는 사용자
- 사고 레벨(thinking level)을 조정하여 코딩 지원 또는 에이전트를 구축하는 사용자
- 무료 계정으로 신규 모델을 테스트하려는 개인 개발자 및 학습자
| 항목 | 내용 |
|---|
| 모델 ID | gemini-4-hydrogen |
| ... | |
요금 세부 정보는 공식 요금 페이지(/docs/pricing#gemini-4-hydrogen)에서 확인할 수 있습니다. | |
기존 3단계에 네 번째 단계인 xhigh가 추가되었습니다.
| 레벨 | 비고 |
|---|
low | 기존과 동일 |
medium | 기존과 동일 |
high | 기본값 (변경 없음) |
xhigh | 신규 추가 |
기본값은 계속 high이므로, 아무것도 지정하지 않은 기존 코드의 동작 방식이 xhigh로 변경되지는 않습니다. 자세한 내용은 /docs/thinking#understanding-thinking-levels를 참조해 주십시오.
Gemini Managed Agents의 Antigravity 에이전트(/docs/antigravity-agent)에서 기본 모델이 gemini-4-hydrogen으로 변경되었습니다.
⚠️ Breaking Change (에 가까운 동작 변경)
Antigravity 에이전트를 모델 지정 없이 이용할 경우, 이전과 다른 모델로 작동하기 때문에 동작 방식, 요금, 응답 경향이 달라질 수 있습니다. 공식 정보에서는 구체적으로 어느 정도 변화하는지는 제시되지 않았으므로, 사용자의 워크로드에서 직접 측정하여 확인하는 것이 안전합니다.
Gemini 3.8 Flash에서 발생한 API 변경점 및 마이그레이션 절차는 'What's new in Gemini 4 Hydrogen'(/docs/whats-new-gemini-4-hydrogen)에 정리되어 있습니다. 3.8 Flash를 사용하는 경우, 반드시 API 변경점을 확인해야 합니다.
11월 11일의 changelog 항목에서 'Gemini Decision'이 'Gemini Decision 1'로 표기 수정되었습니다. 모델 ID gemini-decision-1, 링크 대상, Decisions API의 내용(텍스트/이미지/음성/비디오/PDF를 대상으로 출력 토큰 제로로 빠르고 보정된 이진/카테고리/루브릭 판별)은 모두 변하지 않았습니다. 조치는 필요 없습니다.
Gemini 3.8 Flash 사용자: 마이그레이션 가이드를 읽고 API 변경점을 파악합니다. -
Antigravity 에이전트 사용자: 모델을 지정하지 않은 경우 기본값 변경의 영향을 받습니다. 품질, 비용, 응답 경향을 검증하고 동작 방식을 고정하려면 모델을 명시해 주십시오. -
비용 추산: 입력 $1.50 / 출력 $7.50 per 1M tokens로 재계산합니다. -
사고 레벨 검토: 어려운 작업에 xhigh를 시도해 봅니다. 다만 기본값은 여전히 high입니다. -
사내 문서 업데이트: 모델 목록, 요금, Thinking 설정( xhigh, Antigravity의 기본 모델)을 업데이트합니다.
💡 Tips
무료 티어(Free Tier)가 있으므로, 먼저 기존 프롬프트를 gemini-4-hydrogen로 실행하여 현재 모델과의 출력 차이를 비교하는 것이 낮은 위험도를 가집니다.
월간 입력 2,000만 토큰, 출력 400만 토큰을 처리할 경우의 유료 티어 예상 비용은 다음과 같습니다.
- 입력: 20 × $1.50 = $30
- 출력: 4 × $7.50 = $30
- 합계: 약 $60 / 월
※ 사고 토큰(Thinking Token) 과금 처리 등 자세한 내용은 공식 요금 페이지에서 확인해 주십시오.
아래는 사고 레벨과 모델을 명시하는 경우의 예시입니다. 파라미터 이름이나 표기법은 SDK 버전에 따라 다를 수 있으므로, 반드시 공식 문서를 통해 확인해 주십시오 (입력 데이터에는 코드가 포함되어 있지 않으므로, 구조를 보여주는 참고 예시일 뿐입니다).
Before (모델 및 사고 레벨을 고려하지 않은 상태)
# 모델 지정 없이 Antigravity 에이전트를 사용
# → 향후 gemini-4-hydrogen가 기본값으로 사용됨
agent = create_agent() # 유사 코드
After (모델 및 사고 레벨을 명시)
# 유사 코드: 동작을 고정하고 싶다면 모델을 명시합니다.
response = client.generate(
model="gemini-4-hydrogen",
...
Gemini 4 Hydrogen (코딩/에이전트용으로 빠르고 효율적인 모델이며, 무료 티어가 제공되고 유료 비용은 입력 $1.50 / 출력 $7.50(per 1M tokens)입니다. gemini-4-hydrogen)
가 GA 출시되면서 사고 레벨이 변경되었습니다. 기본값은 xhigh에서 high로 추가되었으며, 기존 코드에 영향을 주지는 않습니다.
- Antigravity 에이전트의 기본 모델이 변경되었습니다. 모델을 지정하지 않은 경우, 동작 방식, 비용, 응답 경향의 변화를 검증해 보시기 바랍니다.
- Gemini 3.8 Flash 사용자는 마이그레이션 가이드에서 API 변경 사항을 확인해 주십시오.
- Gemini Decision 1 표기법 수정은 문서상의 수정만으로 대응할 필요가 없습니다.
우선 무료 티어에서 기존 워크로드를 테스트하고, Antigravity 사용 여부와 모델 지정 상황을 점검하는 것부터 시작하는 것을 권장합니다.
