Skip to main content

google/gemini-4-hydrogen/chat

Google's Gemini 4 Hydrogen chat endpoint handles everyday coding and agent steps, taking text and images and offering four thinking levels within a 1,048,576-token shared context.

Input $1.3247Output $6.6233per 1 million tokensCached input $0.0662

Workbench

Send a request

Quickstart

Examples use the selected endpoint’s public parameter definitions. Replace the API key and example media, then send the request from your server.

SDKs & integrations
POSThttps://api.spicyapi.ai/v1/chat/completions

API authentication

Keep the API key in the server environment variable SPICY_API_KEY. Use Bearer authentication and Content-Type: application/json for JSON requests.

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'

Generated from this model’s input schema — the same one the API validates every request against.

Keep one Idempotency-Key for each logical request. After a network interruption, do not automatically resend with a new key; retain request_id to investigate the accepted request. Idempotency does not replay an earlier chat stream.

Input parameters

Place the model parameters directly in the JSON request body alongside model. This endpoint does not use an input wrapper.

messagesarray<object>Required

The Hydrogen conversation, oldest message first. User messages may mix text parts with image_url parts.

Default
Not specified
Constraints
minItems:1
maxItems:256
response_formatobjectOptional

Ask Hydrogen for JSON, optionally against a json_schema you supply. Validate the result before your code acts on it.

Default
Not specified
tool_choicestring | objectOptional

Whether Hydrogen may call a function on this turn: auto, none, required, or one named function.

Default
Not specified
parallel_tool_callsbooleanOptional

Hydrogen may ask for several functions in a single turn unless you set this to false. Your application still decides what runs.

Default
true
toolsarray<object>Optional

Functions Hydrogen may ask to call, up to 128 definitions. Your application checks the arguments and runs the operation.

Default
Not specified
Constraints
maxItems:128
top_pnumberOptional

Hydrogen accepts values from 0.01 to 1 for client compatibility. Google's documentation says in-range values are ignored here too.

Default
Not specified
Constraints
minimum:0.01
maximum:1
temperaturenumberOptional

Hydrogen accepts values from 0 to 2 for client compatibility. Google's documentation says in-range values are ignored, so replies stay the same.

Default
Not specified
Constraints
minimum:0
maximum:2
stopstring | arrayOptional

One sequence or up to four. Hydrogen ends the reply just before the first match, and the matched text is left out.

Default
Not specified
Constraints
minLength:1
minItems:1
maxItems:4
reasoning_effortstringOptional

How long Hydrogen thinks before replying: low, medium, high or xhigh. The default is high; higher levels use more output tokens.

Default
"high"
Allowed values
"low""medium""high""xhigh"
max_tokensintegerOptional

Hydrogen reply budget from 1 to 65,536, default 4,096. Thinking tokens come out of this budget, so a very small cap can end the call before any text appears.

Default
4096
Constraints
minimum:1
maximum:65536

Read the result

With stream set to false, the request returns the completed chat response directly. Read choices[].message; no task polling is needed. Set stream to true when your client supports Server-Sent Events.

Completed response example
{
  "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
  }
}

The response example is illustrative. usage reports token counts; token counts and charges depend on your actual request.

SDKs & integrations

Use SpicyAPI in your app, terminal, AI assistant or visual workflow. Choose a setup guide below.

Use it in SillyTavern and roleplay apps

In SillyTavern, RisuAI, Agnai or any app with an OpenAI-compatible setting, paste the base URL below and your API key, then pick google/gemini-4-hydrogen/chat as the model. Browser calls are allowed, and sliders this model does not take are ignored instead of rejected.

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

Use it in ComfyUI

Install the SpicyAPI nodes from ComfyUI Manager or with the command below, then pick google/gemini-4-hydrogen/chat in the SpicyAPI Chat node to use this model inside a ComfyUI graph.

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