Gemini 4 Hydrogen은 무엇이고 어떻게 붙이나? 공식 가격 $1.50/$7.50, Claude Code / Codex에서 쓰기

Gemini 4 Hydrogen은 일상 코딩과 에이전트 워크플로를 위한 Google의 효율 모델로, 2026년 11월 12일(미국 시간)에 정식 출시되었습니다. 모델 ID는 gemini-4-hydrogen입니다. 공식 Gemini Developer API 표준 가격은 입력 백만 토큰당 $1.50, 출력(사고 토큰 포함) $7.50, 암시적 캐시 $0.075이며, 무료 등급에서는 이 세 항목이 Free of charge로 표기됩니다. 공식 사양과 가격, AI Studio / Gemini API 연결 방법, Claude Code·Codex·Cursor 설정 방법을 정리합니다.

8 分钟阅读
Gemini 4 Hydrogen은 무엇이고 어떻게 붙이나? 공식 가격 $1.50/$7.50, Claude Code / Codex에서 쓰기

Gemini 4 Hydrogen은 일상 코딩과 에이전트 워크플로를 위한 Google의 효율 모델입니다. Google 공식 블로그(Koray Kavukcuoglu, 2026년 11월 12일)에 따르면 미국 시간 그날 정식 출시되었으며, 베이징 시간으로는 2026년 11월 13일 02:02경입니다. 공식 모델 ID는 gemini-4-hydrogen이고, 컨텍스트는 1M이며, 공식 Gemini Developer API 표준 가격은 입력 백만 토큰당 $1.50, 출력(사고 토큰 포함) $7.50입니다. 긴 구간의 최전선 추론은 여전히 Gemini 4 Carbon과 Gemini 4 Argon이 담당합니다.

2026년 11월 13일(베이징 시간, UTC+8)에 이 사이트의 공개 모델 목록과 https://api.aicodewith.ai/v1/models를 확인했습니다. 목록에는 이미 gemini-4-carbon, gemini-4-argon, gemini-3.8-flash, gemini-3-flash-preview가 있었고, gemini-4-hydrogen이나 분명한 동일 모델 ID는 아직 보이지 않았습니다. 테스트 Key로 이 사이트의 자주 쓰는 진입점 세 곳에 각각 한 번씩 요청을 보냈고, 모두 HTTP 400을 반환하며 모델 gemini-4-hydrogen이 없거나 아직 온라인이 아니라는 메시지였습니다. 이 테스트 머신에는 공식 Gemini API Key가 없어서 공식 Gemini API 호출은 하지 않았습니다. Claude Code, Codex, Cursor에서 Hydrogen 작업도 실행하지 않았습니다. 아래에서는 먼저 공식 문서에 따라 AI Studio / Gemini API 절차를 적고, 이어서 이 사이트에 이미 올라와 있는 Gemini 모델의 세 클라이언트 설정을 제시합니다. 목록에 gemini-4-hydrogen이 보이면 모델 이름만 바꾸면 됩니다.

Create API Key →

먼저 결론

질문답
Hydrogen은 무엇인가?일상 코딩과 에이전트 워크플로를 위한 Google의 효율 Gemini 4 모델. 긴 구간의 최전선 추론은 Carbon / Argon이 담당한다.
모델 IDgemini-4-hydrogen
공식 표준 가격(백만 토큰당, USD)입력 $1.50, 출력(사고 토큰 포함) $7.50, 암시적 캐시 $0.075. 명시적 캐시는 지원하지 않는다.
무료 등급공식 가격 페이지는 입력, 출력, 암시적 캐시를 Free of charge로 표기한다. Search / Maps Grounding은 무료 등급에서 사용할 수 없다.
컨텍스트와 출력컨텍스트 1M. 공식 모델 페이지는 Max output 65K / 1M tokens로 적는다. 모델 카드는 기본 동기 출력을 최대 64K, 백그라운드 long decode로 최대 1M까지로 적는다.
사고 수준공식적으로 low, medium, high(기본값), 그리고 새로 추가된 xhigh.
지금은 어떻게 붙이나?공식 AI Studio 또는 Gemini API를 쓰고 모델 이름을 gemini-4-hydrogen으로 둔다. 이번 실행 시점의 이 사이트 목록에는 이 모델 ID가 아직 보이지 않았다. 이미 올라와 있는 Gemini 모델은 Carbon, Argon, 3.8 Flash 등이다.

Gemini 4 Hydrogen은 무엇인가

공식 출시 블로그와 개발자 공지에 따르면:

  • Hydrogen의 위치는 Gemini 4급 지능을 더 일상적인 코딩과 에이전트 워크플로에 가져오는 것이며, 속도와 효율을 강조합니다.
  • 가장 어려운 긴 구간 추론에는 여전히 Carbon과 Argon을 씁니다. Hydrogen은 일상 실행을 혼자 맡을 수도 있고, 여러 모델을 쓰는 흐름에서 효율적인 실행 엔진이 될 수도 있습니다.
  • Google은 Antigravity에 Orchestrator도 도입해, 같은 세션에서 Carbon과 Hydrogen을 전환합니다. 공식 설명에 따르면 Terminal-Bench 4.0에서 Orchestrator의 성공률은 Carbon에 가깝고, 평균적으로 할당량은 24% 덜 쓰며 19% 더 빨리 끝났습니다.
  • 이용 범위: Google AI Studio의 모든 등급, Gemini API, Gemini for business, Gemini 앱, Google Search, 유료 Google AI Pro / Ultra 구독자의 Google Antigravity. Gemini 앱의 무료 사용자는 프롬프트에 맞을 때 자동 모델 선택을 통해 Hydrogen을 사용합니다.
  • AI Studio에서 바로 시험해 볼 수 있습니다. 안전과 평가에 대한 더 자세한 내용은 공식 Gemini 4 Hydrogen 모델 카드(2026년 11월 12일 게시)에 있습니다. 모델 카드는 지식 컷오프가 2026년 3월이며, 일부 영역은 더 오래되었을 수 있다고도 적습니다.

@GoogleDeepMind, @GeminiApp, @GoogleAIStudio는 출시 당일 발표했습니다. 9to5Google에 따르면 Gemini 앱 모델 선택기에는 4 Hydrogen이 Everyday help로 표시됩니다.

사양 한눈에 보기

아래 표는 공식 모델 페이지, 가격 페이지, 사고 수준 문서, 모델 카드를 정리한 것입니다. 숫자는 공식 원문을 기준으로 하세요.

항목공식 설명
모델 이름Gemini 4 Hydrogen
Gemini API 모델 IDgemini-4-hydrogen
컨텍스트1M tokens
최대 출력공식 모델 페이지: 65K / 1M tokens. 모델 카드: 기본 동기 출력 최대 64K, 백그라운드 long decode로 최대 1M.
입력 모달리티Text, Image, Audio, Video, PDF
사고 수준low, medium, high(기본값), xhigh(Hydrogen에서 신규. Carbon / Argon은 low / medium / high)
캐시암시적 캐시만 지원. 명시적 캐시는 지원하지 않음
무료 등급있음. 가격 페이지는 입력, 출력, 암시적 캐시를 Free of charge로 표기. Grounding은 무료 등급에서 사용 불가. 공식 가격 페이지에 따르면 무료 등급 콘텐츠는 제품 개선에 쓰일 수 있고, 유료 등급은 그렇지 않음.

공식 가격

공식 Gemini Developer API 가격 페이지는 백만 토큰당 미국 달러입니다. 아래는 Hydrogen의 표준 가격입니다. Gemini 3.8 Flash의 $0.75 / $3.75(공식 페이지는 2026년 12월 31일까지 유효하다고 적음)와 섞지 마세요.

항목무료 등급유료 등급(백만 토큰당, USD)
입력Free of charge$1.50
출력(사고 토큰 포함)Free of charge$7.50
컨텍스트 캐시Free of charge$0.075, 암시적 캐시만. 명시적 캐시는 지원하지 않음

유료 등급의 Grounding with Google Search / Maps: Gemini 3 이상 모델이 매달 5,000회의 무료 요청을 공유하고, 이후에는 1,000회당 $14입니다. Search Grounding에는 하루 1,500회 상한도 있습니다. 공식 안내: 사용자 요청 한 번이 여러 검색을 유발할 수 있으며, 실제 쿼리 횟수만큼 청구됩니다. 가격 페이지는 모델이 처리하는 모든 토큰이 집계되고 청구되며, 사고 토큰과 Grounding 사용 시의 내부 도구 시스템 지침 및 함수 선언도 포함된다고 적습니다.

이번 실행 시점의 이 사이트 목록에는 아직 gemini-4-hydrogen이 보이지 않았습니다. 같은 시점에 이미 올라가 있던 Gemini 모델은 gemini-4-carbon, gemini-4-argon, gemini-3.8-flash, gemini-3-flash-preview입니다. 이 ID들의 클라이언트 설정은 아래에 있습니다.

공식 발표 벤치마크

아래 수치는 모두 Google 출시 블로그와 모델 카드에서 가져온 것이며, 우리가 다시 측정한 값이 아닙니다. 시험 설정은 제3자 평가와 다를 수 있으니 공식 주장으로 읽어야 합니다.

공식 블로그에 따르면:

  • Artificial Analysis Intelligence Index: 기본 high에서 51, Argon의 50과 비교. xhigh에서는 54.
  • 기본 high에서 작업을 Gemini 3.8 Flash보다 2.5배 빨리 완료.
  • Terminal-Bench 4.1: 57%. 3.8 Flash의 18.2%와 비교.
  • 공식은 fabricated claims(조작된 주장)가 5배 넘게 줄었다고 합니다.
  • Terminal-Bench 4.0에서 Antigravity Orchestrator의 성공률은 Carbon에 가깝고, 평균적으로 할당량은 24% 덜 쓰며 19% 더 빨리 끝났습니다.

블로그는 Agent Arena 5위, HLE-Diamond 58.8%, Vals Tax Agent Bench 52.3%, Vals Legal Research Bench 55.8%, Multimodal Knowledge Agent(MKA) 53.4%도 언급합니다. 더 자세한 대조표는 모델 카드와 평가 방법 설명에 있습니다.

공식 Gemini API / AI Studio로 연결하기

지금 Hydrogen을 쓸 수 있는 경로입니다. 절차는 공식 빠른 시작, 사고 수준 문서, What's new를 따릅니다. 공식 Key로 이 명령은 실행하지 않았습니다.

  1. Google AI Studio에서 API Key를 만들거나, 먼저 Hydrogen 채팅을 엽니다.
  2. 공식 SDK를 설치합니다. Python은 google-genai, JavaScript는 @google/genai. Key는 환경 변수 GEMINI_API_KEY에 둡니다.
  3. 모델 이름은 gemini-4-hydrogen입니다. 공식 현재 Interactions API 예시는 다음과 같습니다.

Python:

python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Explain how AI works in a few words."
)
print(interaction.output_text)

REST(공식 빠른 시작의 작성법):

bash
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Explain how AI works in a few words"
  }'

사고 깊이는 generation_config.thinking_level로 조절합니다. 공식 기본값은 high입니다. 더 어려운 다단계 코딩과 에이전트 작업에는 xhigh를, 지연과 토큰 사용에 민감한 작업에는 low 또는 medium을 씁니다. 공식 문서는 단순한 텍스트나 JSON 추출에 xhigh를 쓰면 지나치게 생각하거나 max_output_tokens를 소진할 수 있다고 경고합니다. 문서의 Python 형태는 다음과 같습니다.

python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
    generation_config={
        "thinking_level": "xhigh"
    }
)
print(interaction.output_text)

Claude Code / Codex / Cursor에서 쓰기

세 클라이언트는 나란히 다룹니다. 평소 쓰는 것을 고르면 됩니다. 이번 실행 시점의 이 사이트 목록에는 gemini-4-hydrogen 모델 ID가 아직 보이지 않았으므로, 아래 설정을 그 클라이언트에서 Hydrogen을 실행한 결과로 읽지 마세요. 이 사이트에 이미 올라와 있는 Gemini 모델에 해당합니다. 목록에 gemini-4-hydrogen이 보이면 모델 이름만 바꾸면 됩니다. Codex 필드는 《Codex API Key 설정》과 《Codex config.toml 가이드》, Claude Code는 《Claude Code 서드파티 API 설정》을 참고하세요.

이번에 실제로 확인한 내용은 다음과 같습니다.

  • GET https://api.aicodewith.ai/v1/models는 61개 모델을 반환했습니다. Gemini 관련 ID는 gemini-4-carbon, gemini-4-argon, gemini-3.8-flash, gemini-3-flash-preview였고 Hydrogen은 없었습니다.
  • 사이트 공개 목록에도 Hydrogen은 없었습니다.
  • model을 gemini-4-hydrogen으로 한 최소 요청을 https://api.aicodewith.ai/v1/chat/completions, https://api.aicodewith.ai/chatgpt/v1/chat/completions, https://api.aicodewith.ai/v1/messages에 보냈습니다. 세 번 모두 약 0.1~0.2초 만에 HTTP 400을 반환했고, 모델 gemini-4-hydrogen이 없거나 아직 온라인이 아니라는 메시지와 https://aicodewith.ai/zh/dashboard/pricing 안내가 있었습니다.

Claude Code는 ~/.claude/settings.json을 씁니다. 시작할 때 이 사이트에 이미 있는 모델, 예를 들어 gemini-4-argon을 지정합니다.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "내 AICodeWith API Key"
  }
}
bash
claude --model gemini-4-argon -p "Reply with exactly: pong"

Codex는 ~/.codex/config.toml을 씁니다. base_url은 반드시 https://api.aicodewith.ai/chatgpt/v1이어야 하며 /v1로 쓰면 안 됩니다. 전역 experimental_bearer_token을 쓰고, name은 "aicodewith"로 둡니다.

toml
model_provider = "aicodewith"
model = "gemini-4-argon"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "내 AICodeWith API Key"
bash
codex exec --skip-git-repo-check "Reply with exactly: pong"

Cursor에서는 모델 설정에 사용자 지정 API와 모델 이름을 넣을 수 있습니다. 이 경로는 실행하지 않았으므로, 연결 여부는 사용 중인 Cursor 버전에 따릅니다. 목록에 Hydrogen이 나타나면 모델 이름 역시 gemini-4-hydrogen입니다.

공식 Gemini 네이티브 프로토콜을 쓰려면, 이 사이트 문서가 제시하는 Base URL은 https://api.aicodewith.ai/gemini_cli이고, 요청은 POST https://api.aicodewith.ai/gemini_cli/v1beta/models/{model}:generateContent이며, 인증은 Authorization: Bearer에 이 사이트 Key를 붙입니다. 이 경로 역시 목록에 이미 있는 Gemini 모델 ID만 쓸 수 있습니다. 지금 {model}을 gemini-4-hydrogen으로 넣어 통할 것으로 기대하지 마세요.

이 사이트의 다른 Gemini 모델을 먼저 쓰거나, Hydrogen이 올라온 뒤 모델 이름을 바꾸려면 먼저 이 사이트의 API Key를 만드세요.

Create API Key →

자주 보는 오류와 해결

오류 / 증상원인해결
模型 gemini-4-hydrogen 不存在或未上线(HTTP 400)이 사이트 목록에 아직 이 모델 ID가 없음(2026년 11월 13일에 확인)이 사이트의 모델 목록이나 가격 페이지를 확인하세요. 지금 Hydrogen을 쓰려면 공식 AI Studio / Gemini API를 이용하세요. 이 사이트에서는 이미 gemini-4-argon, gemini-4-carbon, gemini-3.8-flash를 쓸 수 있습니다.
Codex가 모델이 없다고 하지만 ID는 이미 목록에 있음base_url이 https://api.aicodewith.ai/v1로 설정됨https://api.aicodewith.ai/chatgpt/v1로 바꿉니다
공식 SDK나 curl이 400 / 403을 반환Key가 없거나 잘못되었거나, 요청이 공식 Gemini 진입점에 닿지 않음환경 변수가 GEMINI_API_KEY인지 확인하고, REST는 https://generativelanguage.googleapis.com/v1beta/interactions로 보내며 x-goog-api-key를 포함하세요
이 사이트 Key를 공식 generativelanguage.googleapis.com에 보내거나, 공식 Gemini Key를 이 사이트에 보냄두 자격 증명과 두 진입점은 섞어 쓸 수 없음공식 Key는 Google API 전용입니다. 이 사이트 Key는 api.aicodewith.ai 전용입니다
출력이 잘리거나, 단순한 추출이 느리고 김thinking_level이 xhigh이거나 max_output_tokens가 너무 작음공식 문서대로 단순한 작업에는 low 또는 medium을 쓰고, max_output_tokens에 여유를 주세요
Gemini 네이티브 요청을 /v1/chat/completions로 보냈더니 예상과 다름이 사이트의 Gemini 네이티브 프로토콜은 /gemini_cli이며 OpenAI 형식 진입점과 섞지 않음generateContent가 필요하면 Base URL을 https://api.aicodewith.ai/gemini_cli로 쓰세요

FAQ

Hydrogen과 Carbon, Argon은 어떻게 고르나요?

공식 블로그에 따르면, 일상 코딩, 테스트, 저장소의 빠른 수정은 Hydrogen을 우선하고, 가장 어려운 긴 구간 추론과 아키텍처 판단은 Carbon 또는 Argon을 씁니다. Google은 Hydrogen을 Gemini 3.8 Flash에서 올라가는 일상용 주요 업그레이드로도 제시합니다. 비교는 《Gemini 4 Carbon 리뷰》와 《Gemini 4 Argon 리뷰》를 참고하세요.

공식 가격이 $1.50 / $7.50인데, 3.8 Flash와 같나요?

같지 않습니다. Hydrogen의 유료 표준 가격은 입력 백만 토큰당 $1.50, 출력 백만 토큰당 $7.50입니다. Gemini 3.8 Flash의 현재 공식 가격은 2026년 12월 31일까지 $0.75 / $3.75이고, 그 이후에는 $1.50 / $7.50입니다. 가격 페이지에서는 반드시 모델 ID와 숫자를 맞춰 확인하세요.

지금 Claude Code나 Codex에서 Hydrogen을 바로 고를 수 있나요?

공식 Gemini API / AI Studio를 통하면 가능합니다. 모델 이름은 gemini-4-hydrogen입니다. 이 사이트 API를 통할 때는 이번 확인 시점에 목록에 이 모델 ID가 없었고, 억지로 넣으면 위의 HTTP 400이 납니다. 이 사이트에서는 이미 Carbon, Argon, 3.8 Flash를 고를 수 있습니다.

무료 등급이 있나요?

공식 가격 페이지에 따르면 Hydrogen 무료 등급에는 입력, 출력, 암시적 캐시가 포함되며 Free of charge로 표기됩니다. Search / Maps Grounding은 무료 등급에서 사용할 수 없습니다. 속도 제한은 Google이 그때그때 공개하는 내용을 따르며, 무료 등급 콘텐츠는 제품 개선에 쓰일 수 있습니다.

자료

Create API Key →