APIMart
전체 모델 목록으로

Gemini 4 Hydrogen API

Google모델 ID gemini-4-hydrogen텍스트 모델2026년 11월 12일 출시

Gemini 4 Hydrogen으로 방금 실패한 테스트를 고치고, 규칙에 따라 티켓을 한꺼번에 배정하고, 보고서 본문과 차트의 숫자를 대조할 수 있습니다.

최대 입력
1,048,576 tokens
최대 출력
65,536 tokens
입력 → 출력
텍스트, 이미지, 오디오, 동영상 → 텍스트
지식 기준일
2026년 3월
  • 이미지 입력
  • 스트리밍 출력
  • 캐시 입력 요금
  • OpenAI SDK 호환

Gemini 4 Hydrogen API 활용 사례

사례마다 설명용 예시를 붙였습니다. 자료, 프롬프트, 직접 정리한 답변 예시이며 모델의 실제 출력이 아닙니다. 프롬프트를 복사해 자신의 자료로 바꾸면 Gemini 4 Hydrogen에서 바로 시험해 볼 수 있습니다.

내 자료로 Gemini 4 Hydrogen 사용해 보기

저장소의 작은 수정과 디버깅

오류, 실패한 테스트, 관련 파일을 함께 넣고 Gemini 4 Hydrogen이 직접적인 원인을 찾아 꼭 필요한 몇 줄만 고치는 수정을 내게 합니다. 고친 뒤에도 테스트는 반드시 돌립니다.

예시: 이 테스트가 갑자기 실패한 이유는?

자료

test_price.py
format_price(1999)가 "$19.99"를 반환해야 하는데 "$1999.00"이 나온다.
price.py
format_price(cents)는 f"${cents:.2f}"를 그대로 반환한다.
최근 커밋
인자 이름을 dollars에서 cents로 바꾸고 단위를 센트로 변경했다.

프롬프트테스트가 실패한 직접적인 원인을 설명하고, 변경이 가장 적은 수정과 함께 고쳐야 할 호출부를 알려 주세요.

답변 예시 · 판단 과정을 보여 주기 위해 직접 정리함

인자가 센트 단위로 바뀌었는데 함수가 100으로 나누지 않습니다. f"${cents / 100:.2f}"로 고치면 됩니다. 아직 달러 단위로 넘기는 호출부도 센트로 넘기게 바꾸지 않으면 금액이 100분의 1이 됩니다.

Gemini 4 Hydrogen API 소개

  • 제미나이 4 하이드로젠, Gemini 4의 빠른 실행 모델

    Google은 제미나이 4 하이드로젠(Gemini 4 Hydrogen)을 일상 코딩과 에이전트 흐름을 실행하는 모델로 소개하고, 깊은 추론은 Gemini 4 Carbon과 Argon에 맡깁니다. 단독으로 써도 되고, 여러 모델을 엮은 흐름에서 호출이 많은 실행 단계를 맡겨도 됩니다.

  • 사고 수준 4단계, 기본값은 high

    Gemini 4 Hydrogen은 low, medium, high, xhigh 네 단계를 지원하며 기본값은 high입니다. Gemini 3.8 Flash에서 넘어오면서 이전 응답 속도를 유지하려면 medium을 명시하면 됩니다.

  • PDF, 표, 오디오, 동영상까지 읽기

    입력은 텍스트, 이미지, 오디오, 동영상을 지원하고 PDF와 Office 문서도 바로 읽습니다. 1,048,576토큰 컨텍스트는 입력과 출력이 함께 쓰며, 지식 기준일은 2026년 3월입니다.

  • Gemini 4 Hydrogen API 키와 연동

    Gemini 4 Hydrogen API 키를 따로 발급받을 필요가 없습니다. APIMart 키 하나로 모든 모델을 호출합니다. Gemini 4 Hydrogen API 사용법은 기존 OpenAI SDK와 같고, Chat Completions 호환 엔드포인트에 모델 ID gemini-4-hydrogen만 지정하면 됩니다.

Gemini 4 Hydrogen 공식 벤치마크 결과

Google가 출시 때 공개한 결과 중 일부입니다.

  • Agents' Last Exam v1.1

    71.6%

    여러 단계로 이뤄진 전문 업무를 평가합니다. GPT-6.1 Terra(69.8%)와 Claude Sonnet 5.5(60.4%)보다 높습니다.

  • Terminal-Bench 4.1

    57.0%

    터미널에서 코딩 작업을 완수하는지 봅니다. Gemini 3.8 Flash(18.2%)의 3배가 넘으며, Claude Sonnet 5.5는 63.9%입니다.

  • AutomationBench-AA

    76.1%

    업무 프로세스 자동화를 평가합니다. Claude Sonnet 5.5(71.8%)와 GPT-6.1 Terra(60.2%)보다 높습니다.

  • SWE-sweep

    13.5%

    코드 저장소에서 개발 작업을 완수하는지 봅니다. Claude Sonnet 5.5는 3.1%, GPT-6.1 Terra는 5.8%입니다.

  • HLE-Diamond

    58.8%

    난도 높은 지식·추론 문제를 평가합니다. Claude Sonnet 5.5(53.3%)와 GPT-6.1 Terra(47.3%)보다 높습니다.

  • Vending-Bench 2

    $14,549

    모델이 모의 자판기를 오래 운영하게 하고 최종 잔액으로 채점합니다. Claude Sonnet 5.5는 $11,165, GPT-6.1 Terra는 $9,107입니다.

Gemini 4 Hydrogen API 사용법

Gemini 4 Hydrogen을(를) 호출하려면 APIMart API 키와 기존 OpenAI SDK만 있으면 됩니다. HTTP 요청을 직접 보내도 됩니다.

POST /v1/chat/completions
curl https://api.apimart.ai/v1/chat/completions \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-4-hydrogen",
  "messages": [
    {
      "role": "user",
      "content": "명확한 API를 설계하는 방법을 세 문장으로 설명해 주세요."
    }
  ],
  "stream": false
}'

Gemini 4 Hydrogen 연결 정보

Model IDgemini-4-hydrogen
Base URLhttps://api.apimart.ai/v1
Endpoint/chat/completions

주요 파라미터

model
필수
messages
필수
stream
선택
max_tokens
선택
temperature
선택
전체 요청 파라미터, 응답 필드, 오류 코드

Gemini 4 Hydrogen API 요청 파라미터

Gemini 4 Hydrogen 모델은 범용 채팅 엔드포인트 POST /v1/chat/completions 를 사용하며 요청 본문은 JSON입니다. model과 messages는 필수이고 나머지 파라미터는 모두 선택 사항입니다.

파라미터타입필수설명
modelstring예모델 ID. 이 모델의 값: gemini-4-hydrogen
messagesarray예대화 메시지 목록입니다. 각 메시지는 role(system, user 또는 assistant)과 content로 구성됩니다. 멀티턴 대화에서는 이전 메시지를 함께 전달합니다.
streamboolean아니요스트리밍 출력 여부입니다. true이면 SSE로 청크 단위로 반환하고, false이면 전체 응답을 한 번에 반환합니다. 기본값: true.
temperaturenumber아니요출력의 무작위성, 0–2. 기본값: 1.0. 값이 낮을수록 출력이 더 결정적입니다.
top_pnumber아니요뉴클리어스 샘플링, 0–1. 기본값: 1.0. 이 값과 temperature 중 하나만 조정합니다.
max_tokensinteger아니요응답에서 생성할 최대 토큰 수입니다.
frequency_penaltynumber아니요빈도 페널티, -2.0 ~ 2.0. 기본값: 0. 양수 값은 같은 표현의 반복을 줄입니다.
presence_penaltynumber아니요존재 페널티, -2.0 ~ 2.0. 기본값: 0. 양수 값은 새로운 주제를 다루도록 유도합니다.
stopstring | array아니요중지 시퀀스, 최대 4개. 그중 하나가 나타나면 생성을 멈춥니다.
ninteger아니요생성할 응답 수. 기본값: 1.

응답 필드

응답에는 아래 필드가 포함됩니다. 토큰 사용량은 usage로 반환되며 비용을 확인하는 데 사용할 수 있습니다.

필드타입설명
idstring요청의 고유 식별자입니다.
modelstring요청을 처리한 모델입니다.
choicesarray응답 목록입니다. 각 항목에는 message(role과 content)와 finish_reason이 포함됩니다.
usageobject토큰 사용량: prompt_tokens, completion_tokens, total_tokens.

오류 코드

요청이 실패하면 code, message, type이 포함된 error 객체가 반환됩니다.

상태 코드타입의미
400invalid_request_error요청 파라미터가 올바르지 않습니다.
401authentication_errorAPI 키가 유효하지 않거나 누락되었습니다.
402payment_required계정 잔액이 부족합니다.
403permission_error이 리소스에 접근할 권한이 없습니다.
429rate_limit_error요청이 너무 많습니다. 잠시 후 다시 시도하십시오.
500server_error서버 내부 오류입니다.
502bad_gateway게이트웨이 오류입니다. 서비스를 일시적으로 사용할 수 없습니다.

Gemini 4 Hydrogen API 가격

Gemini 4 Hydrogen API는 토큰 사용량에 따라 과금되며 가격은 멤버십 등급에 따라 다릅니다. 아래 가격은 토큰 100만 개 기준이며, 1 US 달러 = 10 크레딧입니다.

항목골드현재 가격플래티넘다이아몬드공식 가격절감액
입력12Credits~$1.211.4Credits~$1.1410.8Credits~$1.0815Credits~$1.520%
캐시된 입력0.6Credits~$0.060.57Credits~$0.0570.54Credits~$0.0540.75Credits~$0.07520%
출력60Credits~$657Credits~$5.754Credits~$5.475Credits~$7.520%

가격은 참고용입니다. 전체 가격 보기

APIMart로 Gemini 4 Hydrogen API를 호출하는 이유

  • 공식 가격보다 20% 이상 저렴

    Gemini 4 Hydrogen API는 토큰 사용량만큼 과금됩니다. 골드부터 다이아몬드 등급까지 회원 가격은 Google 공식 가격보다 20%~28% 저렴하며, 캐시된 입력은 100만 tokens당 $0.06입니다.

    회원 등급별 가격 보기
  • API 키 하나로 500+ 모델

    Gemini 4 Hydrogen, 같은 시리즈의 다른 모델, GPT·Claude·Gemini 등 500+ 모델이 API 키 하나와 계정 잔액 하나를 함께 씁니다. 모델을 바꾸려면 model 파라미터만 바꾸면 됩니다.

  • 기존 코드는 두 곳만 수정

    이미 OpenAI SDK를 쓰고 있다면 base_url을 https://api.apimart.ai/v1로, API 키를 APIMart 키로 바꾸면 됩니다. 요청과 응답 형식은 그대로입니다.

  • 코드 전에 온라인으로 먼저

    코드나 환경 설정 없이 Playground에서 내 자료로 Gemini 4 Hydrogen을(를) 시험해 보고, 결과를 확인한 뒤 연동하세요.

    Playground 열기

Google 모델, 무엇을 고를까?

가격은 100만 tokens당 기본 가격(USD)입니다. Gemini 4 Hydrogen API 키로 표의 모든 모델을 호출할 수 있으며 model 파라미터만 바꾸면 됩니다.

Google 같은 시리즈 모델의 차이
비교 항목Gemini 4 Hydrogen 현재Gemini 4 Neon
강점일상 코딩, 에이전트 작업, 채팅 및 질의응답복잡한 코딩, 장시간 에이전트, 분석적 추론
입력 가격$1.2$2.4
출력 가격$6$12

Gemini 4 Hydrogen 자주 묻는 질문

Gemini 4 Hydrogen은 Gemini 4 Argon, Carbon과 무엇이 다른가요?

셋 다 Google Gemini 4 시리즈 모델입니다. Hydrogen은 빠르고 비용이 낮은 모델로 일상 코딩과 에이전트 작업에 맞고, Carbon과 Argon은 더 복잡한 추론에 맞습니다. APIMart에서는 엔드포인트와 API 키가 같아서 model 파라미터만 바꾸면 되며, 각 가격은 가격 페이지에서 볼 수 있습니다.

Gemini 4 Hydrogen 출시일은 언제인가요?

Google은 2026년 11월 12일에 Gemini 4 Hydrogen을 출시했습니다. APIMart는 이미 이 모델을 지원하며, 모델 ID는 gemini-4-hydrogen입니다.

Gemini 3.8 Flash에서 이 모델로 전환하면 무엇이 바뀌나요?

Google 마이그레이션 안내는 gemini-3.8-flash를 gemini-4-hydrogen으로 바꾸라고 권합니다. 기본 사고 수준이 medium에서 high로 바뀌었으니, 이전 응답 속도를 유지하려면 medium을 명시하세요. APIMart로 호출하면 base_url과 API 키는 그대로 두고 model 파라미터만 바꾼 뒤, 자신의 프롬프트로 회귀 테스트를 해 보세요.

Gemini 4 Hydrogen 호출 시 오류가 나는 파라미터는?

Google 개발자 가이드에 따르면 frequency_penalty나 presence_penalty를 보내거나 사고 수준을 minimal로 지정하면 400 오류가 납니다. temperature와 top_p는 무시됩니다. 속도와 비용을 조절하려면 low, medium, high, xhigh 네 단계의 사고 수준을 쓰세요.

이 모델을 온라인에서 사용해 보려면 어떻게 하나요?

'채팅 시작' 또는 'Playground 열기'를 클릭하면 기존 APIMart Playground로 이동합니다. 텍스트 카테고리에서 Gemini 4 Hydrogen 모델을 선택하면 바로 사용해 볼 수 있습니다.

Gemini 4 Hydrogen API의 모델 ID는 무엇인가요?

model에는 gemini-4-hydrogen 값을 사용합니다. 정확한 ID는 페이지 제목 또는 연동 정보 패널에서 복사할 수 있습니다.

OpenAI SDK와 호환되나요?

OpenAI SDK를 그대로 사용할 수 있습니다. base_url을 https://api.apimart.ai/v1 로 설정하고 APIMart API 키를 입력한 다음 이 페이지의 모델 ID를 사용합니다.

Gemini 4 Hydrogen의 컨텍스트 윈도우는 얼마인가요?

APIMart에서 Gemini 4 Hydrogen의 최대 입력은 요청당 1,048,576 토큰입니다. 프롬프트, 이전 메시지, 파일 내용이 모두 여기에 포함됩니다.

한 번에 최대 몇 토큰까지 출력할 수 있나요?

Gemini 4 Hydrogen 모델은 한 번의 응답에서 최대 65,536 토큰까지 출력할 수 있습니다. max_tokens 파라미터로 더 낮은 한도를 설정할 수 있습니다.

Gemini 4 Hydrogen API 가격은 얼마인가요?

APIMart의 Gemini 4 Hydrogen API는 토큰 단위로 과금되며 가격은 멤버십 등급에 따라 다릅니다. 골드: 입력 토큰 100만 개당 $1.2, 출력 토큰 100만 개당 $6. 다이아몬드: 입력 토큰 100만 개당 $1.08, 출력 토큰 100만 개당 $5.4. 가격은 변경될 수 있으며 현재 요율은 가격 페이지에서 확인할 수 있습니다.

스트리밍을 지원하나요?

지원합니다. 범용 채팅 엔드포인트는 기본적으로 SSE로 스트리밍합니다. stream을 false로 설정하면 전체 응답을 한 번에 받습니다.

API 키는 어떻게 발급받나요?

APIMart에 로그인하여 API Keys 페이지에서 키를 생성한 다음 Authorization: Bearer 헤더에 넣어 전송합니다. 같은 키로 플랫폼의 다른 모델도 사용할 수 있습니다.