본문으로 건너뛰기

google/gemini-4-hydrogen/chat

Google의 Gemini 4 Hydrogen 채팅 엔드포인트는 일상적인 코드와 에이전트 단계를 처리하며, 텍스트와 이미지를 받고 1,048,576토큰 공유 컨텍스트에서 4단계 사고 수준을 제공합니다.

입력 $1.3247출력 $6.6233100만 토큰당캐시된 입력 $0.0662

플레이그라운드

요청 보내기

빠른 시작

예시는 선택한 엔드포인트의 공개 파라미터 정의를 사용합니다. API 키와 예시 미디어를 바꾼 뒤 서버에서 요청하세요.

SDK 및 연동
POSThttps://api.spicyapi.ai/v1/chat/completions

API 인증

API 키는 서버 환경 변수 SPICY_API_KEY에 보관하세요. Bearer 인증을 사용하고 JSON 요청에는 Content-Type: application/json을 지정하세요.

Authorization: Bearer $SPICY_API_KEY
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도 모든 요청을 같은 스키마로 검증합니다.

논리적으로 같은 요청 하나에는 같은 Idempotency-Key를 계속 쓰세요. 네트워크가 끊겼다고 새 키로 자동 재전송하지 말고, 접수된 요청을 나중에 확인할 수 있도록 request_id를 남겨 두세요. 앞서 받던 채팅 스트림이 다시 흘러나오지는 않습니다.

입력 파라미터

모델 파라미터는 JSON 요청 본문에서 model과 같은 수준에 넣습니다. 이 엔드포인트는 input으로 감싸지 않습니다.

messagesarray<object>필수

Hydrogen과의 대화를 오래된 메시지부터 순서대로 보냅니다. 사용자 메시지에는 텍스트와 image_url 파트를 함께 넣을 수 있습니다.

기본값
지정되지 않음
제약 조건
minItems:1
maxItems:256
response_formatobject선택

Hydrogen에 JSON 출력을 요청하며 직접 만든 json_schema도 지정할 수 있습니다. 코드에서 사용하기 전에 결과를 검증해야 합니다.

기본값
지정되지 않음
tool_choicestring | object선택

이번 턴에서 Hydrogen의 함수 호출 여부를 지정합니다. auto, none, required 또는 특정 함수를 선택할 수 있습니다.

기본값
지정되지 않음
parallel_tool_callsboolean선택

false로 설정하지 않으면 Hydrogen은 한 턴에 여러 함수를 요청할 수 있습니다. 무엇을 실행할지는 계속 애플리케이션이 결정합니다.

기본값
true
toolsarray<object>선택

Hydrogen이 호출을 요청할 수 있는 함수이며 최대 128개까지 정의합니다. 인수 확인과 작업 실행은 애플리케이션이 담당합니다.

기본값
지정되지 않음
제약 조건
maxItems:128
top_pnumber선택

Hydrogen은 클라이언트 호환성을 위해 0.01부터 1까지의 값을 받습니다. Google 문서에 따르면 이 값도 무시됩니다.

기본값
지정되지 않음
제약 조건
minimum:0.01
maximum:1
temperaturenumber선택

Hydrogen은 클라이언트 호환성을 위해 0부터 2까지의 값을 받습니다. Google 문서에 따르면 범위 내 값은 무시되므로 응답은 달라지지 않습니다.

기본값
지정되지 않음
제약 조건
minimum:0
maximum:2
stopstring | array선택

시퀀스를 하나 또는 최대 네 개까지 지정합니다. Hydrogen은 처음 일치하는 위치 바로 앞에서 응답을 끝내며 일치한 문자열은 반환하지 않습니다.

기본값
지정되지 않음
제약 조건
minLength:1
minItems:1
maxItems:4
reasoning_effortstring선택

Hydrogen이 응답 전에 사고하는 정도입니다. low, medium, high, xhigh 중에서 선택하며 기본값은 high입니다. 수준이 높을수록 출력 토큰을 더 사용합니다.

기본값
"high"
허용 값
"low""medium""high""xhigh"
max_tokensinteger선택

Hydrogen의 응답 예산으로 1부터 65,536까지 지정하며 기본값은 4,096입니다. 사고 토큰도 여기에서 차감되므로 너무 작으면 본문 없이 호출이 끝날 수 있습니다.

기본값
4096
제약 조건
minimum:1
maximum:65536

결과 읽기

stream이 false이면 완성된 채팅 응답이 바로 반환됩니다. choices[].message를 읽으면 되며 작업을 폴링할 필요가 없습니다. Server-Sent Events를 지원하는 클라이언트에서는 stream을 true로 설정할 수 있습니다.

완료 응답 예시
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-4-hydrogen/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

응답은 구조를 보여 주는 예시입니다. usage는 토큰 수이며 실제 사용량과 요금은 요청에 따라 달라집니다.

SDK 및 연동

앱, 터미널, AI 어시스턴트 또는 시각적 워크플로에서 SpicyAPI를 사용하세요. 원하는 설정 가이드를 선택하세요.

SillyTavern과 롤플레이 앱에서 사용하기

SillyTavern, RisuAI, Agnai 등 OpenAI 호환 설정이 있는 앱에 아래 기본 URL과 API 키를 붙여 넣고 모델로 google/gemini-4-hydrogen/chat을(를) 선택합니다. 브라우저에서 바로 호출할 수 있으며, 이 모델이 받지 않는 슬라이더 값은 오류 없이 무시됩니다.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-4-hydrogen/chat

ComfyUI에서 쓰기

ComfyUI Manager나 아래 명령으로 SpicyAPI 노드를 설치한 뒤 SpicyAPI Chat 노드에서 google/gemini-4-hydrogen/chat을(를) 고르면 ComfyUI 그래프 안에서 이 모델을 쓸 수 있습니다.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi