Gemini 4 Hydrogen

네이티브 Gemini 형식으로 gemini-4-hydrogen을 사용하세요. 모델 페이지에는 Playground와 현재 요금이 있습니다. Gemini 4 Hydrogen은 Gemini 4 Argon과 같은 요청 형식을 사용하며, Google 가이드에 따르면 전환할 때 모델 ID만 바꾸면 됩니다.

모델 ID

예제를 실행하기 전에 모델 목록과 사용 가능한 등급을 확인하세요. Default 등급을 사용할 수 없으면 검색 결과에서 반환된 전체 호출 ID를 사용합니다.

빠른 예제

curl https://api.seedrouter.ai/v1beta/models/gemini-4-hydrogen:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

모델은 URL에 지정합니다. contents는 필수입니다. 답변에는 네이티브 candidates, finishReason 및 usageMetadata가 포함됩니다. 대화 기록에 thoughtSignature를 포함한 전체 콘텐츠 파트를 보존하세요. 어려운 프롬프트는 몇 분이 걸릴 수 있습니다. Google은 클라이언트 제한 시간을 20분으로 설정할 것을 권장합니다. 준비되는 대로 출력을 받으려면 스트리밍을 사용하세요.

엔드포인트

OpenAPI 사양에는 모든 중첩 요청 및 응답 스키마가 포함됩니다. 선택 필드를 생략하면 API 기본값이 적용됩니다. 공개 네이티브 API는 제출된 본문을 보존하여 Gemini가 검증하도록 합니다. Playground는 제출 전에 문서화된 제약 조건도 확인하고 안전 설정을 적용합니다.

요청 매개변수

URL은 모델을 gemini-4-hydrogen으로 고정합니다. 요청 계약에는 최상위 필드 11개가 있습니다. 필수로 표시하지 않은 필드는 선택 사항이며 생략은 JSON null과 다릅니다. 공식 스키마가 허용하는 곳에서는 null을 허용하는 임의의 JSON이 보존됩니다.

Gemini 4 Hydrogen은 명시적 컨텍스트 캐싱(cachedContent 및 cachedContents 리소스)을 지원하지 않습니다. 4,096 토큰 이상의 프롬프트에는 암시적 캐싱이 기본으로 켜져 있습니다.

생성 매개변수

OpenAPI 문서에는 각 메시지의 중첩 유형, 열거형, 필수 속성과 문서화된 경계가 나열되어 있습니다. 스키마는 공식 매개변수를 설명하며 SeedRouter 요청 허용 목록이 아닙니다. 호출자가 제공한 필드와 값은 보존됩니다. 스키마가 필드를 허용한다고 모든 계정에서 지원된다는 뜻은 아닙니다. minimal 사고는 명시된 수준에 없습니다. Google은 temperature, topP, topK 및 candidateCount가 사용이 권장되지 않아 제거해야 한다고 명시하며, 사용자 지정 샘플링 값은 무시됩니다. 네이티브 JSON으로 제출해도 Gemini API가 처리하도록 그대로 전달됩니다.

긴 답변 분할 생성

Gemini 4 Hydrogen의 응답 한 회는 스트리밍에서 최대 65,536 토큰, 비스트리밍에서도 최대 65,536 토큰을 반환합니다. 더 생성하려면 maxOutputTokens를 65,536보다 크게 설정하고 직접 답변을 이어서 생성하세요.

1. 요청을 보냅니다. 응답이 finishReason: "CONTINUATION"으로 끝나면 candidates[0].continuationToken을 읽습니다.
2. 그 값을 최상위 continuationToken 필드에 넣어 같은 요청을 다시 보냅니다. 부분 출력을 contents에 추가하지 마세요. 토큰에는 사고를 포함한 모델의 상태가 담깁니다.
3. finishReason이 STOP 또는 MAX_TOKENS가 될 때까지 반복합니다.

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

응답 한 회를 전부 사고에 사용하면 빈 텍스트와 CONTINUATION이 반환될 수 있으며, 이는 정상적인 진행입니다. 매회 프롬프트와 지금까지 생성된 모든 내용이 모델로 다시 전송되므로 이후 각 회차에 입력 토큰이 다시 계산됩니다. SeedRouter는 각 회차를 독립 요청으로 과금합니다. Interactions API의 서버 측 background 모드는 이 엔드포인트에 포함되지 않습니다.

구조화된 출력

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 65536,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

기존 responseSchema와 responseJsonSchema 필드는 함께 사용할 수 없습니다. 둘 다 responseMimeType: "application/json"이 필요합니다. 새 responseFormat.text 스키마도 JSON을 지정해야 합니다. 해당 메시지에는 REST 열거형 표기(APPLICATION_JSON 및 TEXT_PLAIN)를 사용하세요. 요청은 그대로 전달되며 미디어 MIME 유형과 임의의 함수 JSON은 다시 작성되지 않습니다.

함수와 내장 도구

tools[].functionDeclarations에 이름과 parameters 또는 parametersJsonSchema 중 하나만 사용하세요. 둘 다 사용할 수는 없습니다. 함수 선택은 toolConfig.functionCallingConfig에 있으며, allowedFunctionNames에는 ANY 또는 VALIDATED와 선언된 이름이 필요합니다.

애플리케이션이 반환된 함수를 실행하고 다음 대화 턴에서 결과를 제공합니다. 원래의 thoughtSignature, 함수 호출과 함수 응답을 각각 보존하세요. 불투명한 함수 인수를 직렬화할 때 숫자 식별자를 반올림하지 마세요.

Google은 이 모델에 Search, Maps, 코드 실행, URL 컨텍스트, File Search 및 Computer Use를 명시합니다. File Search 리소스는 요청을 처리하는 인증 정보로 접근할 수 있어야 합니다. 네이티브 MCP 설정은 범용 스키마에 있지만 이 모델에서 사용할 수 있는지는 확립되지 않았습니다. 미디어와 함께 사용하기 전에 각 도구의 공식 제한을 확인하세요. 그라운딩을 사용하면 Google은 내부 도구 지시와 함수 선언을 입력 토큰으로 계산합니다. Playground는 사용자 지정 함수를 실행하지 않습니다.

멀티모달 입력과 안전

contents[].parts[]의 각 항목에는 텍스트, 인라인 미디어, 파일 참조, 함수 호출/응답 또는 실행 파트 중 정확히 하나의 페이로드가 들어갑니다. 서명이나 미디어 메타데이터도 포함할 수 있습니다. 입력은 텍스트, 이미지, 오디오, 동영상과 PDF를 지원하며 출력은 텍스트뿐입니다. 모델은 이미지나 오디오 생성 및 Live API를 제공하지 않습니다.

인라인 바이트에는 inlineData.mimeType과 base64 data를 사용합니다. 파일 참조에는 fileData.mimeType과 fileUri를 사용합니다. 문법적으로 유효한 URL이라고 모델이 가져올 수 있다는 뜻은 아닙니다. 동영상 메타데이터에는 시작/종료 오프셋과 24 이하의 양수 fps를 지정할 수 있습니다. 동영상의 fileData 또는 inlineData 옆에 mediaProcessing: "AGENTIC"을 지정하여 파트별로 에이전트형 동영상 이해를 선택합니다. 기본값은 정적 처리입니다. videoMetadata에는 startOffset, endOffset 및 fps만 들어갑니다.

안전 설정은 공식 네이티브 형식을 사용하며 API를 통해 그대로 전달됩니다. Playground에서는 네 범주를 모두 BLOCK_MEDIUM_AND_ABOVE 또는 더 엄격하게 설정해야 합니다. 더 낮은 기준은 API로만 사용할 수 있습니다.

JSON 응답과 스트리밍

generateContent는 네이티브 JSON을 반환합니다. streamGenerateContent?alt=sse는 SSE data: 이벤트로 네이티브 JSON을 내보냅니다. 주요 필드는 candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId 및 usageMetadata입니다.

대화 기록에 전체 네이티브 콘텐츠를 보존하세요. 사고 요약은 사고 서명과 다릅니다. 연결이 끊겼다고 생성이 실패하거나 완료되었다고 판단할 수는 없습니다. 다른 요청을 보내기 전에 부분 결과와 계정 기록을 확인하세요. 스트림 사용량은 누적되므로 청크를 모두 합하지 말고 최신 카운터를 사용합니다.

사용량과 요금

promptTokenCount에는 캐시 입력이 포함됩니다. cachedContentTokenCount는 캐시 입력 요율로 과금되며 비캐시 입력으로 중복 과금되지 않습니다. 과금 출력은 candidatesTokenCount와 thoughtsTokenCount의 합계입니다. Hydrogen의 기본 사고 수준은 high입니다. 다른 모델과 사용량을 비교할 때는 수준을 명시하세요.

이 모델에는 컨텍스트 길이에 따른 요금 구간이 없습니다. 현재 SeedRouter 요금은 Standard 토큰 요율을 사용하며 이 통합에는 Flex 할인과 Priority 할증이 설정되지 않았습니다. 해당 처리 등급의 지원은 여전히 검증이 필요합니다. Google Search 그라운딩은 토큰 사용량 외에 쿼리당 요금을 추가할 수 있으므로 활성화 전에 도구 요금을 확인하세요. 실패한 요청은 과금되지 않습니다. 실시간 가격표를 참조하세요.

계정 그룹

Default 등급은 접미사 없는 gemini-4-hydrogen 모델 ID를 사용합니다. 추가 등급은 URL에서 gemini-4-hydrogen:GROUP_NAME을 사용합니다. Playground는 사용 가능한 등급을 선택하며 API에는 다음 헤더를 명시할 수도 있습니다.

X-SeedRouter-Group: GROUP_NAME

선택한 그룹이 가격과 사용 가능한 용량을 결정합니다. 명시적으로 선택하면 다른 그룹으로 조용히 전환되지 않습니다. 헤더를 생략하거나 auto를 사용하면 API 키의 기본 동작이 유지됩니다.

응답을 생성하지 않고 API 키에서 사용 가능한 그룹을 확인하세요.

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-hydrogen" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

검증 상태

공식 문서를 2026년 11월 13일에 확인했습니다. 당일 SeedRouter를 통한 각 한 번의 유료 확인 세 건이 통과했습니다. low 사고의 구조화된 JSON, xhigh 사고의 SSE, low 사고의 선언된 함수 호출입니다. 보고된 입력, 출력, 사고 토큰 수는 공개 요금으로 계산했을 때 기록된 청구액과 일치했습니다. 미디어 이해, 그라운딩, Computer Use, 이어서 생성/긴 디코딩, 기타 일반 필드 및 처리 등급은 여전히 검증되지 않았습니다. 이 확인으로 비교 품질이나 지연 시간을 입증할 수는 없습니다.

참고 자료

• Google 모델 사양
• Gemini 4 Hydrogen의 새로운 기능
• generateContent를 사용한 긴 답변 분할 생성
• 사고
• 요금
• GenerateContent REST 참조