소개
OpenAI 채팅 형식으로 메시지를 보내면 텍스트, 도구 호출 또는 스키마에 맞는 JSON을 받습니다. 사고 수준, 응답 길이, 중지 시퀀스는 선택 사항입니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 텍스트 |
| 공유 컨텍스트 | 1,048,576토큰 |
| max_tokens 상한 | 65,536 |
핵심 기능 및 하이라이트
매일 반복되는 작업에 맞춘 설계
Google은 Hydrogen을 저장소 수정, 디버깅, 하루에도 여러 번 반복되는 에이전트 단계에 맞춰 소개합니다. 깊은 탐색보다 빠른 응답이 중요한 작업에 적합합니다.
네 단계로 조절하는 사고
이름 변경에는 low, 일반적인 수정에는 medium이나 high, 두 번 고쳐도 통과하지 못한 테스트에는 xhigh를 사용합니다.
코드로 검증할 수 있는 응답
response_format에 JSON 스키마를 전달하거나 tools에 함수를 선언합니다. Hydrogen이 다음 단계를 제안하고 실행 여부는 애플리케이션이 결정합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | Hydrogen과의 대화를 오래된 메시지부터 순서대로 보냅니다. 사용자 메시지에는 텍스트와 |
max_tokens | 아니요 | Hydrogen의 응답 예산으로 1부터 65,536까지 지정하며 기본값은 4,096입니다. 사고 토큰도 여기에서 차감되므로 너무 작으면 본문 없이 호출이 끝날 수 있습니다. |
reasoning_effort | 아니요 | Hydrogen이 응답 전에 사고하는 정도입니다. low, medium, high, xhigh 중에서 선택하며 기본값은 high입니다. |
stop | 아니요 | 시퀀스를 하나 또는 최대 네 개까지 지정합니다. Hydrogen은 처음 일치하는 위치 바로 앞에서 응답을 끝내며 일치한 문자열은 반환하지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
temperature | 아니요 | Hydrogen은 클라이언트 호환성을 위해 0부터 2까지의 값을 받습니다. Google 문서에 따르면 범위 내 값은 무시되므로 응답은 달라지지 않습니다. |
top_p | 아니요 | Hydrogen은 클라이언트 호환성을 위해 0.01부터 1까지의 값을 받습니다. Google 문서에 따르면 이 값도 무시됩니다. |
tools | 아니요 | Hydrogen이 호출을 요청할 수 있는 함수이며 최대 128개까지 정의합니다. 인수 확인과 작업 실행은 애플리케이션이 담당합니다. 128개 이하 |
parallel_tool_calls | 아니요 | false로 설정하지 않으면 Hydrogen은 한 턴에 여러 함수를 요청할 수 있습니다. 무엇을 실행할지는 계속 애플리케이션이 결정합니다. 기본값: |
tool_choice | 아니요 | 이번 턴에서 Hydrogen의 함수 호출 여부를 지정합니다. auto, none, required 또는 특정 함수를 선택할 수 있습니다. |
response_format | 아니요 | Hydrogen에 JSON 출력을 요청하며 직접 만든 json_schema도 지정할 수 있습니다. 코드에서 사용하기 전에 결과를 검증해야 합니다. |
요금
입력 $1.3247 / 출력 $6.6233 100만 토큰당
활용 사례
실패하는 테스트 고치기
스택 트레이스와 관련 파일 두 개를 붙여 넣고 Hydrogen에 가장 작은 패치와 실패 원인을 요청합니다.
에이전트를 단계별로 실행하기
함수 목록을 모델에 전달하고 요청된 호출을 실행해 결과를 돌려줍니다. 단계 수 제한은 직접 작성한 코드에서 관리합니다.
고객 지원에서 스크린샷 분석하기
오류 화면의 스크린샷을 첨부하고 어떤 설정이 원인인지, 사용자가 다음에 무엇을 시도해야 하는지 묻습니다.
프롬프트 가이드 및 실전 팁
낮은 수준부터 시작하기
먼저 low나 medium을 사용하고 답변에 빠진 내용이 있을 때만 수준을 높입니다. 높은 수준일수록 응답 전에 더 많은 출력 토큰을 사용합니다.
사고에 쓸 예산 남기기
사고 토큰도 max_tokens에서 차감됩니다. 수십 토큰 정도의 상한은 본문이 나오기 전에 소진될 수 있으므로 여유 있게 설정합니다.
변하지 않는 내용을 앞에 두기
지침과 긴 참고 자료는 대화 앞부분에 배치합니다. 반복되는 앞부분에는 더 낮은 캐시 입력 요금이 적용될 수 있습니다.
Gemini 4 Hydrogen은 일상적인 코딩과 에이전트 워크플로를 위한 Google의 고속 추론 모델입니다.
google/gemini-4-hydrogen/chat — /v1/chat/completions
reasoning_effort를 low, medium, high, xhigh 중에서 지정합니다. 사고는 max_tokens를 사용하므로 본문에 쓸 공간을 남겨 두어야 합니다.
이미지는 image_url 파트로 첨부하고, 함수는 tools에 선언하며, 스키마에 맞는 JSON은 response_format으로 요청합니다.
Hydrogen 요청에는 Google의 안전 시스템이 적용되므로 일부 프롬프트는 거부될 수 있습니다.
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-hydrogen/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.













