# Gemini 4 Hydrogen: 코딩, 사고 수준, API 사용법

> Gemini 4 Hydrogen의 코딩 초점, 사고 수준 기본값, API 접근 방법을 정리합니다. Carbon·Argon과의 차이와 전환 전 점검도 다룹니다.

- Canonical HTML: https://omniakey.com/ko/blog/gemini-4-hydrogen
- Markdown: https://omniakey.com/ko/blog/gemini-4-hydrogen.md
- Published: 2026-11-12 (updated 2026-11-12)
- Author: Kiki, COO at OmniaKey
- Language: ko
- Category: Guide
- Reading time: 8 min
- All posts: https://omniakey.com/blog/llms.txt

---

**Google은 2026년 11월 12일 Gemini 4 Hydrogen을 공개했습니다.** 일상 코딩과 도구를 사용하는 에이전트가 주 용도입니다. AI Studio와 Gemini API 무료·유료 등급에서 사용할 수 있으며 GenerateContent와 Interactions API 모두에서 호출됩니다. 모델 ID는 `gemini-4-hydrogen`이고 사고 수준 기본값은 high입니다. 먼저 아래 접근 경로를 확인한 뒤 자신의 작업으로 수준을 시험해 보세요.

## Gemini 4 Hydrogen을 사용할 수 있는 곳

아래 접근 정보는 2026년 11월 12일 미국 동부 시간(UTC 11월 13일)에 확인했습니다. Google의 [공개 글](https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/)과 [새 기능 안내](https://ai.google.dev/gemini-api/docs/whats-new-gemini-4-hydrogen)는 Hydrogen을 Gemini API의 무료 등급과 유료 등급에 올려 두었습니다. AI Studio에서도 제공합니다. [모델 페이지](https://ai.google.dev/gemini-api/docs/models/gemini-4-hydrogen)는 Stable로 표시되어 있고 2026년 11월에 업데이트되었습니다. [변경 로그](https://ai.google.dev/gemini-api/docs/changelog)는 정식 제공일을 2026년 11월 12일로 적고 있습니다. 개발자는 GenerateContent나 Interactions API를 선택할 수 있습니다.

무료 등급에는 속도 제한이 있고 Google 검색과 Google 지도 그라운딩은 포함되지 않습니다. Google의 [가격 페이지](https://ai.google.dev/gemini-api/docs/pricing)에 적힌 내용입니다. 공개 글은 Gemini 앱, 검색, Gemini for business, Sheets에서의 제공도 언급합니다. Antigravity는 Google AI Pro와 Ultra 유료 구독자를 대상으로 합니다.

OmniaKey는 Hydrogen을 [Gemini 4 Hydrogen](https://omniakey.com/ko/gemini-4-hydrogen)으로, ID `gemini-4-hydrogen`으로 등록했습니다. 모델 페이지에서 현재 OmniaKey의 지원 기능과 가격을 확인할 수 있습니다. 아래 REST 예시는 Google의 호스트를 사용하며 Google의 Gemini API를 설명합니다. 사고 수준, 긴 출력, 가격, 벤치마크 정보도 Google에 해당하는 내용입니다. Interactions, 긴 출력 및 기타 Google 엔드포인트는 별도 기능이므로 의존하기 전에 모델 페이지를 확인하세요. Google의 무료 등급은 Google의 Gemini API에 속하며, OmniaKey는 사용량을 별도로 청구합니다. 더 긴 다단계 작업에는 [Gemini 4 Argon](https://omniakey.com/ko/gemini-4-argon)이 계속 등록되어 있습니다. Flash 계열 워크플로에는 [Gemini 3.8 Flash](https://omniakey.com/ko/gemini-3-8-flash)를 사용할 수 있습니다. 전환하기 전에 [현재 모델 목록](https://omniakey.com/ko/models)을 확인하세요.

## 일상 코딩과 도구를 쓰는 에이전트에 맞춘 모델

Google은 Hydrogen을 일상 코딩, 대화형 웹 앱, 도구를 사용하는 에이전트를 위한 빠르고 효율적인 모델로 설명합니다. 멀티모달 문서 작업과 병렬로 실행되는 하위 에이전트 작업도 대상입니다. Gemini Managed Agents의 Antigravity 에이전트에서는 기본 모델입니다. Google은 Gemini 3.8 Flash와 이전 Gemini 3 모델에서 업그레이드할 것도 권합니다. 더 어려운 추론과 긴 시간 범위의 작업은 계속 Carbon과 Argon이 맡습니다.

공개 글에는 Google의 주장도 담겨 있습니다. Gemini 3.8 Flash보다 깔끔한 코드를 낸다는 주장, Terminal-Bench 4.1에서 57.0%를 기록했다는 주장(Gemini 3.8 Flash는 18.2%), high에서 작업이 2.5배 빨리 끝난다는 주장입니다. 이 수치는 Google이 낸 것이고 기술 세부 내용은 Google 문서를 따릅니다. 성능 수치는 Google의 보고이며, 이번에 Hydrogen을 새로 직접 측정한 결과가 아닙니다. 전환을 결정하기 전에 어떤 주장을 자신의 작업에서 확인할지 정해 두면 좋습니다.

## 사고 수준은 기본 high, 어려운 작업은 xhigh

high에서 시작하고 다단계 코딩이나 에이전트 작업에서 high로 부족할 때만 xhigh를 시험하세요. Google의 [사고 안내](https://aistudio.google.com/docs/thinking)에는 네 가지 수준이 있습니다.

|수준|토큰 사용량|적합한 용도|
|-|-|-|
|low|가장 적음|빠른 채팅, 대량 처리|
|medium|적은 편|대화형 코딩, UI 작업|
|high(기본)|균형|대부분의 코딩과 에이전트 작업|
|xhigh|가장 많음|어려운 다단계 문제|

Google은 minimal을 받지 않으며 가장 가벼운 수준은 low입니다. medium은 대화형 코딩이나 UI 작업을 더 빠르게 진행하고 싶을 때 먼저 시험할 수준입니다. low는 대량 채팅과 단순 처리에 맞습니다. xhigh는 토큰을 가장 많이 쓰고 단순한 추출 작업에서는 지나치게 오래 생각할 수 있어 일상 호출의 기본값으로는 적합하지 않습니다.

같은 수준 이름이 모델마다 같은 토큰 예산을 뜻하거나 동일한 연산량을 보장하지는 않습니다. Google은 각 수준을 상대적인 토큰 사용량으로 설명하며 수준 이름에 고정 토큰 수를 붙이지 않습니다. Hydrogen의 기본값은 high이고 최고 수준은 xhigh입니다. Carbon과 Argon의 기본값은 medium이고 최고 수준은 high입니다. 처음 비교할 때는 작업, 출력 한도, 수준을 같게 맞춰 측정합니다. 다만 그것은 출발점일 뿐입니다. 총 토큰과 채택한 결과를 함께 보고 모델마다 수준과 한도를 조정하세요.

## Google 문서의 REST 요청 예시

다음 요청은 Google 사고 안내에서 가져온 예시입니다. 수준을 low로 두고 해당 페이지에 나온 `Api-Revision` 헤더를 붙였습니다.

```bash
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Api-Revision: 2026-05-20" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Provide a list of 3 famous physicists and their key contributions",
    "generation_config": {
      "thinking_level": "low"
    }
  }'
```

API 키는 `GEMINI_API_KEY` 환경 변수에 넣고 `x-goog-api-key` 헤더로 보냅니다. 이 호출에는 SDK 설치가 필요 없습니다. 평가할 때는 `thinking_level`을 medium, high, xhigh로 바꾸세요. 예시에는 `max_output_tokens`가 없으므로 동기 호출 기본값인 65,536이 적용됩니다. `thinking_level`은 `generation_config` 안에 들어갑니다. 호출을 바꿔도 이 중첩 구조를 유지하세요.

## 컨텍스트, 출력 한도, 도구 이어가기

입력, 사고, 출력은 하나의 1,048,576토큰 창을 함께 씁니다. 동기 호출은 출력 65,536토큰에서 멈춥니다. Interactions API에서는 Google의 [긴 출력 안내](https://aistudio.google.com/docs/long-decode)에 따라 입력 토큰을 뺀 최대 1,048,576토큰까지 출력할 수 있습니다. 생성은 64K토큰 단위로 이어집니다. 백그라운드 모드에는 `store: true`가 필요하고 최대 24시간 실행됩니다. 그래도 `max_output_tokens`를 생략하면 65,536에서 멈춥니다. 클라이언트 측 전경 이어가기도 같은 안내에서 설명합니다.

`max_output_tokens`는 사고와 출력을 합친 한도입니다. 한도가 빡빡하면 상태가 incomplete가 되거나 텍스트가 잘리거나 아무 텍스트도 나오지 않을 수 있습니다. 비용이나 지연을 줄이고 싶다면 먼저 `thinking_level`을 낮추세요. Interactions API의 다중 턴 도구 사용에서는 `store: true`와 `previous_interaction_id`로 상태를 유지할 수 있습니다. 상태를 저장하지 않는 Interactions 모드에서는 모든 `thought` 블록을 그대로 다시 보내야 합니다. GenerateContent는 기록을 클라이언트가 관리한다는 점이 다릅니다. 이전 모델 턴과 thought signature를 그대로 돌려보내고 병렬 `functionCall` 사이에 signature를 복사하지 마세요.

## 요청 한 번의 비용

Google의 표준 유료 가격은 입력 100만 토큰당 $1.50, 출력 100만 토큰당 $7.50입니다. 출력에는 사고 토큰이 포함됩니다. 캐시 입력은 100만 토큰당 $0.075이며 Google은 암시적 캐싱만 지원합니다. 모두 위 확인 시점의 Google 정가입니다.

|항목|가격|
|-|-:|
|입력|$1.50 / 100만|
|캐시 입력|$0.075 / 100만|
|출력(사고 포함)|$7.50 / 100만|

예를 들어 캐시되지 않은 입력 10,000토큰, 표시되는 출력 1,000토큰, 사고 1,000토큰을 생각해 보겠습니다. 입력은 10,000 × $1.50 / 100만 = $0.015입니다. 청구되는 출력은 2,000토큰이므로 2,000 × $7.50 / 100만 = $0.015입니다. 합계는 $0.03입니다. 이 계산에는 도구, 재시도, 캐시 적중이 빠져 있습니다.

Google 무료 등급에는 속도 제한이 있습니다. Batch, Flex, Priority는 별도의 사용 방식이며 각자 다른 가격을 가집니다. 표준 대화형 요청에 이 요금을 적용하지 마세요. Carbon과 Argon에는 무료 등급이 없습니다. Google은 2026년 11월 30일까지 100만 토큰당 입력 $2이고 출력 $10입니다. 12월 1일부터는 $4와 $20입니다.

## Hydrogen, Carbon, Argon의 역할과 전환

세 Gemini 4 모델은 1M 통합 컨텍스트, 긴 출력 설계, 내장 도구를 공유합니다. Google은 추론 깊이, 지연 시간, 토큰 사용량으로 역할을 나눕니다.

|모델|기본 수준|최고 수준|Google의 위치|
|-|-|-|-|
|Hydrogen|high|xhigh|일상 코딩, 대화형 앱, 도구 에이전트|
|Argon|medium|high|긴 다단계 작업, Carbon보다 적은 토큰 사용|
|Carbon|medium|high|어려운 아키텍처, 디버깅, 과학, 보안 감사|

Google은 Carbon을 가장 강한 프런티어 모델로 부르며 어려운 아키텍처, 디버깅, 과학, 보안 감사에 맞춥니다. Argon은 Carbon보다 적은 토큰으로 진행하는 고급 장기 작업에 적합합니다. Hydrogen은 일상 코딩과 에이전트 실행을 위한 빠르고 효율적인 선택입니다. Google 페이지는 모든 작업에서 이기는 모델 하나를 정하지 않습니다. 맡은 작업에 맞춰 고르고 자신의 프롬프트로 시험하세요.

더 큰 모델을 고르는 기준은 [Carbon과 Argon 비교](https://omniakey.com/ko/blog/gemini-4-carbon-vs-argon)에서 볼 수 있습니다. 코딩 중심의 Argon 예시는 [Argon 코딩 테스트](https://omniakey.com/ko/blog/gemini-4-argon-coding-test)에 있습니다.

Carbon이나 Argon에서 전환할 때 요청 구조는 바뀌지 않습니다. `model`을 `gemini-4-hydrogen`으로 두고 high가 아닌 수준이 필요하면 `thinking_level`을 설정하세요. Hydrogen의 비스트리밍 한 단계 출력 한도는 65,536토큰입니다. Carbon과 Argon의 비스트리밍 REST 한 단계 한도는 32,768토큰입니다. Interactions API에서 턴을 넘겨 모델을 바꿀 때는 `previous_interaction_id`를 쓰거나 상태를 저장하지 않는 모드에서 thought 단계를 보존하세요.

Gemini 3.8 Flash에서 옮길 때는 너무 낮은 `max_output_tokens`를 올리거나 삭제하고 명시적 캐시 필드와 샘플링 매개변수(`temperature`, `top_p`, `top_k`)를 삭제하세요. thought signature는 유지해야 합니다. 암시적 캐싱은 프롬프트 토큰 4,096개부터 시작합니다. 전체 이전 목록은 Google의 [새 기능 안내](https://ai.google.dev/gemini-api/docs/whats-new-gemini-4-hydrogen)에 있습니다.

## 전환 전에 확인할 항목

운영 환경의 모델 문자열을 바꾸기 전에 다음 항목을 차례로 확인하세요.

1. 정확한 ID `gemini-4-hydrogen`을 쓴다. gemini-4-flash 같은 ID를 추측하지 않는다.
2. 입력, 사고, 출력을 1,048,576토큰 공통 창 안에 넣는다.
3. 답 하나가 65,536토큰을 넘으면 Interactions API의 긴 출력을 쓴다. 클라이언트 측 이어가기나 `store: true`를 쓰는 백그라운드 모드를 선택한다.
4. 먼저 medium과 high를 시험하고 high로 부족한 작업에만 xhigh를 더한다.
5. 명시적 캐시와 샘플링 필드를 삭제한다. 암시적 캐싱은 4,096토큰 이상의 같은 프롬프트 앞부분이 반복될 때만 작동한다.
6. 상태를 쓰는 Interactions API(`store: true`, `previous_interaction_id`)나 클라이언트가 관리하는 GenerateContent 기록을 고른다. thought signature는 그대로 유지한다.
7. 도구와 모달리티를 확인한다. 입력은 텍스트, 이미지, 비디오, 오디오, PDF이고 출력은 텍스트다. 이미지 생성, 오디오 생성, Live API는 지원하지 않는다.

## 자주 묻는 질문

### Gemini 4 Hydrogen은 무료인가요?

Google은 속도 제한이 있는 무료 등급을 제공합니다. 유료 등급은 입력 100만 토큰당 $1.50, 출력 100만 토큰당 $7.50입니다.

### Gemini 4 Hydrogen은 Gemini 4 Flash와 같은 모델인가요?

Google은 Hydrogen을 별도 모델로 등록하며 Flash와 같다고 밝힌 공식 페이지는 없습니다. [Gemini 4 Flash 공개일 페이지](https://omniakey.com/ko/blog/gemini-4-flash-release-date)는 별개의 Flash 질문을 추적합니다. Hydrogen에는 Hydrogen ID를 쓰고 Flash ID가 공개된 뒤에 Flash를 호출하세요.

### 세 모델 모두 high이면 연산량이 같은가요?

수준 이름에 고정 토큰 예산이 붙지 않으며 같은 연산량을 보장하지도 않습니다. Google은 각 수준을 상대적 토큰 사용량으로 설명하고 모델마다 기본값과 최고 수준이 다릅니다. Hydrogen은 기본 high에 xhigh까지, Carbon과 Argon은 기본 medium에 high까지입니다. 처음 비교할 때 작업, 출력 한도, 수준을 맞추고 나서 총 토큰과 채택한 결과를 측정해 모델별로 조정하세요.

### Hydrogen의 최대 출력은 얼마인가요?

동기 호출은 출력 65,536토큰에서 멈춥니다. Interactions API의 긴 출력에서는 입력 토큰을 뺀 최대 1,048,576토큰까지 올릴 수 있습니다. 백그라운드 모드나 클라이언트 측 이어가기로 64K토큰씩 생성합니다. 사고 토큰도 이 한도에 포함됩니다.

## 확인한 출처

- [Google: Introducing Gemini 4 Hydrogen](https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/)(2026년 11월 12일)
- [Google: Gemini 4 Hydrogen 모델 페이지](https://ai.google.dev/gemini-api/docs/models/gemini-4-hydrogen)(2026년 11월 13일 UTC 확인)
- [OmniaKey: Gemini 4 Hydrogen 모델 페이지](https://omniakey.com/ko/gemini-4-hydrogen)(카탈로그 등록 정보, 2026년 11월 13일 UTC 확인)
- [Google: What's new in Gemini 4 Hydrogen](https://ai.google.dev/gemini-api/docs/whats-new-gemini-4-hydrogen)(2026년 11월 13일 UTC 확인)
- [Google: Gemini API 변경 로그](https://ai.google.dev/gemini-api/docs/changelog)(2026년 11월 12일)
- [Google: Gemini API 가격](https://ai.google.dev/gemini-api/docs/pricing)(2026년 11월 13일 UTC 확인)
- [Google: 사고 안내](https://aistudio.google.com/docs/thinking)(2026년 11월 13일 UTC 확인)
- [Google: 긴 출력 안내](https://aistudio.google.com/docs/long-decode)(2026년 11월 13일 UTC 확인)

Hydrogen은 현재 OmniaKey에 등록되어 있습니다. 현재 지원 기능과 가격은 [Gemini 4 Hydrogen 모델 페이지](https://omniakey.com/ko/gemini-4-hydrogen)에서 확인하세요.