Gemini 4 Hydrogen으로 텍스트·이미지 작업을 처리하고 low, medium, high, xhigh 사고 수준을 선택하세요. EvoLink 통합 API로 구조화된 정보 추출과 도구 호출을 구현하며, 하나의 API 키로 OpenAI 호환 Chat Completions 또는 Gemini 네이티브 API를 사용할 수 있습니다.
프로덕션 라우트이 성공률은 플랫폼 측 가용성을 나타냅니다. 확인된 서버 오류(HTTP 500 / 빈 응답)만 실패로 집계됩니다. 사용자 측 문제(콘텐츠 검열, 잘못된 파라미터, 취소)와 속도 제한, 타임아웃, 인증 오류는 제외됩니다. 실제 트래픽이 들어오기 전에는 빈 구간이 가용으로 표시될 수 있습니다.라이브
Gemini 4 Hydrogen은 출처가 반환되지 않아도 비어 있지 않은 검색 쿼리마다 과금합니다. 요청 하나에서 여러 쿼리가 실행될 수 있습니다. 검색 요금은 토큰 최소 요금을 적용한 후 별도로 더해집니다.
Google 검색$0.014/ 쿼리·0.952 cr / 쿼리
Gemini 4 Hydrogen이란?
Gemini 4 Hydrogen(제미나이 4 하이드로젠)은 Google의 Gemini 4 계열 모델로, EvoLink에서는 gemini-4-hydrogen으로 제공합니다. 텍스트와 이미지를 입력받아 텍스트, 구조화된 JSON 또는 함수 호출을 반환합니다. 사고 수준, Google Search, 자동 접두부 캐싱으로 작업 실행 방식을 제어할 수 있습니다. 아래 워크플로로 이미지 추출, 고객 지원 답변, 도구 사용을 평가하세요. 토큰 단가만으로 작업 비용이 가장 낮은 모델을 판단할 수는 없습니다.
Gemini 4 Hydrogen 사양과 기능
숫자는 EvoLink 경로 설정에서 가져오며, 기능은 API가 현재 제공하는 범위입니다.
컨텍스트 윈도우
1.05M 토큰
최대 출력
1.05M 토큰
입력
텍스트 + 이미지 + 영상 + 파일
출력
텍스트 · JSON(구조화 출력) · 도구 호출
추론
추론 강도 설정 가능
도구 사용
여러 단계 도구 시퀀스를 지원하는 함수 호출
프롬프트 캐싱
자동 캐시 읽기, 더 낮은 요금
서버 측 도구
Google 검색, 검색 쿼리당 과금
프로토콜
Chat Completions · Gemini 네이티브 API
모델 ID
gemini-4-hydrogen
Gemini 4 Hydrogen 활용 사례
입력, 필요한 출력, 실패 조건에 맞춰 워크플로를 선택하세요. 오류가 사용자나 업무 기록에 영향을 준다면 애플리케이션 검증과 사람의 검토를 유지해야 합니다.
Gemini 4 Hydrogen으로 이미지를 JSON으로 추출
청구서 스크린샷이나 상품 이미지에 고정된 필드 스키마를 함께 보내세요. 이미지에서 확인되는 값만 추출하고, 없거나 읽을 수 없는 필드는 null로 반환하도록 요청합니다. 기록을 저장하기 전에 자료형, 금액, 필수 필드를 검증하고 불확실한 결과는 검토로 넘기세요. 재시도를 포함한 필드 정확도와 통과한 기록당 비용을 측정합니다.
Gemini 4 Hydrogen으로 문서 기반 고객 지원
공통 고객 지원 지침과 정책 문서를 매번 달라지는 고객 질문과 대화 앞에 배치하세요. 답변은 해당 근거 안에서 작성하고, 정보가 없거나 서로 충돌하면 담당자에게 넘기도록 요구합니다. 반복 접두부는 캐싱을 활용할 수 있습니다. 캐시 읽기, 답변 수용률, 응답 시간, 담당자 이관 비율을 함께 측정하세요.
Gemini 4 Hydrogen 도구 호출 에이전트
주문 상태를 조회할 때 모델이 주문 ID 스키마에 맞는 조회 인수를 제안하게 하세요. 애플리케이션이 검증하고 함수를 실행한 뒤 결과를 모델에 반환해 최종 답변을 만듭니다. 호출 기록에 사고 서명을 유지하세요. 웹 근거가 필요한 경우에만 Google Search를 사용하고, 쿼리·재시도·도구 실행 횟수를 제한합니다. 유효한 도구 호출이 작업 완료를 입증하지는 않습니다.
Gemini 4 Hydrogen 이미지에서 JSON 추출 예시
작업과 통과 기준을 설명하는 예시이며 실제 기록된 모델 응답이나 벤치마크가 아닙니다. 선명한 이미지, 필드 스키마, 정답이 표시된 기준 자료로 결과를 평가하세요.
입력과 요청 필드
청구서 이미지에 ACME Corp, USD 1,240.50, 납부 기한 2026-12-01이 선명하게 보인다고 가정합니다. vendor, currency, total, due_date를 구조화된 JSON으로 요청하세요. 없거나 읽을 수 없는 값은 null로 반환하고 일반 지식으로 빈 정보를 채우지 않도록 지시합니다.
저장 전 통과 판정
이 설명용 입력의 기대값은 vendor = ACME Corp, currency = USD, total = 1240.50, due_date = 2026-12-01입니다. 애플리케이션은 JSON 스키마를 확인하고 원본과 값을 대조합니다. 스키마가 유효해도 금액이 틀리면 통과할 수 없습니다. 금액을 읽을 수 없다면 자동 재시도를 반복하지 말고 검토로 넘기세요.
Gemini 4 Hydrogen을(를) 사용하는 두 가지 방법: EvoLink API 또는 Agent
프로덕트 백엔드와 배치 작업에는 EvoLink API를, 코딩·분석 워크플로에는 Codex, Claude, Gemini에서 Gemini 4 Hydrogen을(를) 직접 호출하세요. 두 경로 모두 같은 EvoLink API 키, 잔액, 모델 ID, 요청 기록을 공유합니다.
방법 1
EvoLink API로 통합
적합한 용도: 프로덕트 백엔드, 배치 작업, 자동화 파이프라인
Gemini 네이티브 generateContent 요청을 EvoLink로 보내고 모델 ID, 시스템 지침, 출력 예산, 도구, 구조화 출력을 직접 제어합니다.
1콘솔에서 EvoLink API 키를 만드세요
2EvoLink base URL의 generateContent 엔드포인트를 호출하고 위에 표시된 모델 ID를 요청 경로에 넣으세요
3대표 요청을 한 번 보내고 usageMetadata에서 입력·캐시·출력 토큰을 확인하세요
4작업별로 maxOutputTokens와 재시도를 설정하고, 여러 턴에서는 함수 호출과 그 결과를 유지하세요
# Gemini native API
curl -X POST "https://direct.evolink.ai/v1beta/models/gemini-4-hydrogen:generateContent" \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"systemInstruction": { "parts": [{ "text": "Extract the fields and answer in JSON only." }] },
"contents": [
{ "role": "user", "parts": [{ "text": "Invoice: ACME Corp, total $1,240.50, due 2026-12-01" }] }
],
"generationConfig": {
"maxOutputTokens": 2048,
"responseMimeType": "application/json",
"thinkingConfig": { "thinkingLevel": "low" }
}
}'
# thinkingLevel accepts low, medium, high (default), or xhigh. Gemini 4 Hydrogen thinks at
# every level, and thinking tokens are billed at the output rate.
# For streaming, call streamGenerateContent?alt=sse with the same body.
# The response includes candidates[0].content.parts and usageMetadata
# (prompt, thinking, and output token counts).
잘못된 요청 또는 지원하지 않는 파라미터
API 레퍼런스를 기준으로 모델 ID, contents 배열, 파라미터 범위를 확인하고 이 경로가 지원하지 않는 필드를 제거하세요.
인증 또는 잔액 문제
Authorization Bearer 토큰을 확인하고 콘솔에서 사용 가능한 잔액을 확인하세요.
컨텍스트 길이 초과
프롬프트 토큰이 Gemini 4 Hydrogen의 컨텍스트 윈도우를 초과했습니다. 관련 근거만 잘라내거나 검색해 넣고 캐시된 프리픽스를 재사용하세요.
속도 제한(429)
지터를 두고 백오프 후 재시도하고, 병렬 버스트 대신 배치나 큐로 보내세요.
콘텐츠 또는 도구 호출 거부
재시도 전에 민감한 콘텐츠, 잘못된 tool-call 인자, JSON 스키마 불일치를 확인하세요.
Gemini 4 Hydrogen API 연동 점검 항목
애플리케이션이 이미 지원하는 프로토콜에서 EvoLink API 키를 사용하세요. 프로덕션 작업을 Hydrogen으로 보내기 전에 다음 네 항목을 확인합니다.
01
모델 ID 설정
Chat Completions는 요청 본문의 model을 "gemini-4-hydrogen"로 설정합니다. 네이티브 API는 /v1beta/models/{model}:generateContent 경로에 해당 ID를 사용합니다. 두 프로토콜의 요청 구조는 다릅니다.
필수
02
사고 수준 선택
Chat Completions의 reasoning_effort 또는 네이티브 thinkingConfig의 thinkingLevel을 low, medium, high, xhigh로 설정하세요. 지정하지 않으면 high가 적용됩니다. 작업 통과 기준을 만족하는 수준부터 시작하고 오류가 남으면 다른 수준을 시험합니다. 높은 수준이 품질을 보장하지 않으며 low도 사고 비용이 발생할 수 있습니다. 선택한 수준을 사용량 로그에 남기세요.
비용 관리
03
출력과 도구 예산 설정
요청마다 maxOutputTokens(Chat Completions에서는 max_tokens)를 설정하세요. 출력에는 사고 토큰도 포함됩니다. Google Search는 토큰과 별도로 쿼리당 과금되며 요청 하나가 여러 쿼리를 실행할 수 있습니다. 전체 작업의 도구 실행과 재시도 횟수에 상한을 두세요.
비용 관리
04
전환 전 비교
현재 모델이 품질과 비용 목표를 이미 충족하면 기존 경로를 유지하세요. 어려운 사례와 실패 사례를 포함한 소규모 대표 작업으로 Hydrogen을 시험합니다. 통과한 결과가 총지출과 응답 시간 측면에서 전환을 뒷받침할 때만 경로를 바꾸세요. 검증된 대체 경로를 남겨 두고 검증이나 도구 작업 완료에 실패하면 되돌립니다.
평가
Gemini 4 Hydrogen 사고 토큰과 비용
사고 수준은 요청을 제어하는 설정이며 고정 토큰 할당량이나 품질·비용 개선을 보장하지 않습니다. 추출은 스키마와 필드 정확도, 고객 지원은 근거 활용, 에이전트는 도구 작업 완료를 확인하세요. 표본에서 이 검사를 통과하는 설정 중 비용이 가장 낮은 것을 선택합니다. 사고 토큰은 출력 요금(100만 토큰당 $6.750)으로 과금됩니다. 아래 사용량 예시에서 중복 계산을 피하는 방법을 설명합니다.
1,048,576토큰 윈도우 하나, 스트리밍 요청 한 번에 최대 65,536토큰
입력·사고·출력은 1,048,576토큰 컨텍스트 윈도우 하나를 함께 쓰며, 이보다 긴 입력의 요청은 거부됩니다. 스트리밍 요청 한 번이 반환하는 것은 사고와 답변을 합쳐 최대 65,536토큰입니다. 더 길게 받으려면 네이티브 API에서 maxOutputTokens를 이 한도보다 크게 설정하세요. 응답이 종료 사유 CONTINUATION으로 끝나면 continuationToken이 함께 오며, 이 토큰을 넣어 같은 요청을 다시 보내면 출력이 이어지고 STOP으로 끝나거나 maxOutputTokens에 도달할 때까지 반복합니다. Chat Completions는 이어받을 수 없으며, 한도에서 잘린 응답은 finish_reason "length"로 끝납니다.
Gemini 4 Hydrogen 사용량과 작업 비용 읽기
아래 토큰 수는 설명용입니다. 기존 계산기에 캐시되지 않은 입력, 캐시 읽기, 과금 대상 출력을 나눠 입력하세요. 보고된 프롬프트 사용량에 캐시 적중분이 포함되어 있다면 입력란에 넣기 전에 해당 부분을 빼야 합니다. 검색 쿼리 수는 별도로 추가하세요.
네이티브 API: 보이는 출력과 사고 합산
usageMetadata가 보이는 출력 300토큰과 사고 200토큰을 보고한다면 두 부분을 합친 500토큰에 출력 요금이 적용됩니다. 입력과 캐시 사용량은 따로 읽으세요. 이 예시는 과금 범주를 설명하며 Hydrogen이 실제로 사용할 사고량을 예측하지 않습니다.
Chat Completions: 사고 토큰 중복 계산 방지
completion_tokens가 500이고 reasoning 상세가 200토큰이면 이 200은 이미 500에 포함됩니다. 출력을 700으로 입력하지 마세요. 여러 요청으로 구성된 작업은 모든 시도의 토큰·도구 비용을 합산하고 통과한 작업 수로 총지출을 나눠 경로를 비교합니다.
Gemini 4 Hydrogen과 Gemini 4 Argon, Gemini 3.8 Flash 비교
EvoLink
아래 현재 요금을 가격 기준으로 삼으세요. 새 모델이라고 자동으로 더 저렴하지는 않으며 Gemini 3.8 Flash의 토큰 단가가 Hydrogen보다 낮을 수 있습니다. 단가는 답변 품질, 재시도 횟수, 작업 완료를 나타내지 않습니다. 아래 선택 기준에서 기존 경로를 유지할 때와 다른 모델을 평가할 때를 설명합니다.
적합한 용도코딩·추론·에이전트 작업의 기존 Flash 기준 모델입니다. 품질, 응답 시간, 총비용이 목표에 맞으면 계속 사용할 수 있습니다.
워크로드에 맞는 Gemini 경로 선택
경로를 선택하는 기준이며 벤치마크 순위가 아닙니다. 위의 현재 요금표와 이미 실행 중인 작업의 요구 사항을 함께 보세요.
Gemini 3.8 Flash가 이미 잘 맞으면 유지
기존 경로가 통과 기준을 만족하고 응답 시간과 비용 목표에 맞으면 유지하세요. 현재 Flash 단가가 낮다면 새 모델로 옮기는 것보다 유리할 수 있습니다. 작업 실측 결과가 전환을 뒷받침할 때만 Hydrogen을 도입하세요. 새 세대라는 사실만으로 이전할 이유는 되지 않습니다.
텍스트·이미지 워크플로에서 Hydrogen 평가
배포하려는 사고 수준으로 이미지에서 JSON 추출, 근거 기반 고객 지원, 함수 호출을 시험하세요. 필드 오류, 담당자 이관, 완료된 도구 작업, 재시도, 청구 사용량을 비교합니다. EvoLink API 키와 프로토콜은 기존 클라이언트에 맞을 수 있지만 모델 설정과 도구 기록은 여전히 검증해야 합니다.
Hydrogen이 요구 사항을 못 채우면 Argon 평가
Hydrogen이 수용 기준을 충족하지 못하면 같은 어려운 사례로 Argon을 평가하세요. 트래픽을 옮기기 전에 각 모델 페이지에서 기능과 프로토콜 제한을 확인하세요. Token 단가가 높다고 더 나은 결과가 보장되지는 않습니다. 긴 출력을 사용하는 워크플로에서는 사용할 프로토콜의 이어쓰기 동작과 공유 컨텍스트 예산을 확인하세요.
direct.evolink.ai에서 EvoLink API 키와 "gemini-4-hydrogen"를 사용하세요. 이 경로는 OpenAI 호환 Chat Completions와 Gemini 네이티브 API를 지원합니다. Google AI Studio, Gemini 앱, 다른 공급자의 사용 가능 여부는 별도로 확인해야 합니다.
Gemini 4 Hydrogen API에는 어떤 모델 ID를 써야 하나요?
"gemini-4-hydrogen"를 사용하세요. Chat Completions는 요청 본문의 model에 설정하고 네이티브 API는 /v1beta/models/{model}:generateContent 경로에 사용합니다. 두 프로토콜의 요청 구조는 다릅니다.
EvoLink의 Gemini 4 Hydrogen API 요금은 얼마인가요?
입력 100만 토큰당 $1.350, 출력 100만 토큰당 $6.750, 캐시된 입력 100만 토큰당 $0.068입니다. 사고 토큰은 출력 요금으로 과금되고 Google Search 쿼리는 추가 비용이 발생합니다. 표시된 할인은 100만 토큰당 입력 $1.500, 출력 $7.500, 캐시된 입력 $0.075을 비교 기준으로 사용합니다. 계산기로 예상한 뒤 실제 사용량과 재시도를 대조해 통과한 작업당 비용을 구하세요.
Gemini 4 Hydrogen은 어떤 용도로 쓸 수 있나요?
이미지에서 JSON 추출, 자체 문서에 근거한 고객 지원 답변, 함수 호출 워크플로를 평가할 수 있습니다. Readme에 청구서 작업과 통과 기준을 설명하는 예시가 있습니다. 구조화된 출력이 곧 정확한 결과라고 가정하지 말고 불확실한 필드와 미완료 도구 작업을 검토하세요.
사고 수준은 Gemini 4 Hydrogen 가격에 어떤 영향을 주나요?
reasoning_effort 또는 네이티브 thinkingLevel을 low, medium, high, xhigh로 설정합니다. 지정하지 않으면 high를 사용하며, xhigh는 가장 오래 사고해 지연 시간과 출력 토큰이 가장 많습니다. 모든 수준에서 출력으로 과금되는 사고 토큰이 발생할 수 있고 높은 설정이 더 나은 답변을 보장하지 않습니다. 숫자로 지정하는 사고 예산은 지원하지 않습니다. 네이티브 API와 Chat Completions의 집계 방식은 Readme에서 설명합니다.
EvoLink는 어떤 입력·출력·도구를 지원하나요?
텍스트·이미지·오디오·동영상·PDF 입력, 구조화된 JSON 출력, 함수 호출, Google 검색은 두 프로토콜 모두에서 사용할 수 있습니다. Word·PowerPoint·Excel 파일은 Gemini 네이티브 API에서 인라인 데이터나 파일 URL로 사용할 수 있습니다. Chat Completions에서는 Office 파일 URL을 받지 않으므로 base64 파일 데이터로 보내세요. 함수 호출 기록을 다시 보낼 때는 이전 응답의 사고 서명을 함께 넣으세요.
Gemini 4 Hydrogen 프롬프트 캐시는 어떻게 작동하나요?
반복 접두부는 자동으로 캐시될 수 있으며 읽기는 캐시된 입력 요금으로 과금됩니다. 고정 지침과 공유 문서를 변하는 사용자 내용보다 앞에 배치하세요. 매 요청이 캐시에 적중한다고 가정하지 말고 캐시 사용량을 확인합니다. 이 경로는 명시적인 캐시 생성을 지원하지 않습니다.
Gemini 4 Hydrogen 컨텍스트 윈도우와 출력 한도는 얼마인가요?
입력·사고·출력은 1,048,576토큰 윈도우 하나를 함께 쓰며, 이보다 긴 입력의 요청은 거부됩니다. 스트리밍 요청 한 번이 반환하는 것은 사고와 답변을 합쳐 최대 65,536토큰입니다. 네이티브 API에서는 더 긴 출력을 여러 요청에 걸쳐 이어받을 수 있습니다. 응답이 종료 사유 CONTINUATION으로 끝나면 그 continuationToken을 넣어 같은 요청을 다시 보내고, STOP으로 끝날 때까지 반복하세요. maxOutputTokens는 이 요청들 전체의 총 예산입니다.
OpenAI 호환 요청과 스트리밍을 지원하나요?
네. direct.evolink.ai에서 동일한 EvoLink API 키와 모델 ID로 OpenAI 호환 Chat Completions 또는 Gemini 네이티브 API를 사용합니다. 둘 다 스트리밍을 지원하며 네이티브 API는 streamGenerateContent에 alt=sse를 붙입니다. 마지막 청크의 사용량으로 청구 토큰을 대조하세요. 요청 본문과 도구 기록은 선택한 프로토콜을 따라야 합니다.
Gemini 4 Hydrogen과 Gemini 4 Argon은 어떻게 고르나요?
EvoLink에서 Hydrogen의 토큰 단가는 Argon보다 낮지만 완료 작업당 비용이 더 낮다는 증거는 아닙니다. 재시도와 도구 비용을 반영해 요구 사항을 충족하는 경로를 유지하세요. ID만 바꿔도 설정과 기록을 검증해야 하며 두 모델의 증류 아키텍처 관계는 확인되지 않았습니다.
Gemini 4 Hydrogen은 Gemini 4 Flash와 같은 모델인가요?
커뮤니티에서는 Hydrogen을 Gemini 4 Flash라고 부르기도 합니다. 이 명칭은 이 페이지의 API 별칭이 아니며 공식 이름이나 아키텍처를 확인하는 근거도 아닙니다. 여기서 설명하는 EvoLink 경로에서는 Flash ID를 추측하지 말고 "gemini-4-hydrogen"를 사용하세요.