Models

gemini-4-hydrogen — API, Pricing & Context Window | Vivgrid

gemini-4-hydrogen on Vivgrid: Google's fast, efficient Gemini 4 model for everyday coding and agentic workflows, with a 1M-token context window, 64K max output, and text, image, video, audio, and PDF input.

gemini-4-hydrogen brings Gemini 4 intelligence with speed and efficiency to everyday coding and agentic enterprise workflows. Adapted from gemini-4-carbon, it is the lowest-cost model in the Gemini 4 series on Vivgrid. It pairs a ~1.05M-token context window with up to 64K max output tokens and accepts text, image, video, audio, and PDF inputs.

On Vivgrid, gemini-4-hydrogen runs as a globally centralized model reachable through the same OpenAI-compatible endpoint and unified key as every other model in the catalog.

Specifications

ProviderGoogle
Model IDgemini-4-hydrogen
Best forCoding
Available onChat Completions, Vibe coding
Context window1,048,576 tokens
Max output65,536 tokens
ModalitiesText, Image, Video, Audio, PDF
Tool / function callingYes
Knowledge cutoff2026-03
Acceleration🌐 Global (Centralized)

Pricing

Pricing in USD per 1M tokens.

InputCached inputOutput
$1.50$0.075$7.50

What one request costs

The rates above applied to a 20K-token prompt with a 2K-token reply — a typical single agent turn, small enough that every request is billed at the base rate.

RequestCost
Cold prompt, nothing cached$0.0450
Warm prompt, 90% of the input served from cache$0.0193

Input is priced at $1.50 per 1M tokens (one rate for text, image, video, and audio), cached input at $0.075 per 1M tokens, and output (including thinking tokens) at $7.50 per 1M tokens, with a single flat rate across the full context window.

Use gemini-4-hydrogen in your coding agent

gemini-4-hydrogen works with the same Vivgrid key and https://api.vivgrid.com/v1 endpoint as every other model in the catalog. Grab your API key from the Vivgrid Console, then drop one of the configurations below into your agent of choice.

OpenCode

OpenCode has Vivgrid built in, so you can use gemini-4-hydrogen without writing any config: open /models, search for vivgrid, paste your API key and pick the model. The OpenCode tutorial walks through it step by step.

Prefer to configure it by hand? Install OpenCode:

npm i -g opencode-ai

Declare gemini-4-hydrogen under the Vivgrid provider in your global OpenCode config, ~/.config/opencode/opencode.json. The @ai-sdk/openai-compatible provider talks to Vivgrid over Chat Completions (/v1/chat/completions):

~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "vivgrid/gemini-4-hydrogen",
  "provider": {
    "vivgrid": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Vivgrid",
      "options": {
        "baseURL": "https://api.vivgrid.com/v1",
        "apiKey": "{env:VIVGRID_API_KEY}"
      },
      "models": {
        "gemini-4-hydrogen": {
          "name": "gemini-4-hydrogen",
          "tool_call": true,
          "attachment": true,
          "modalities": { "input": ["text", "image", "video", "audio", "pdf"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 65536 }
        }
      }
    }
  }
}

Export your key and launch OpenCode:

export VIVGRID_API_KEY="viv-xxxxxxxxxxxxx"
opencode

Use /models to switch between gemini-4-hydrogen and other Vivgrid models mid-session. See the full OpenCode tutorial.

Pi

Install Pi:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Add gemini-4-hydrogen to the Vivgrid provider in ~/.pi/agent/models.json. Pi talks to Vivgrid over Chat Completions (/v1/chat/completions):

~/.pi/agent/models.json
{
  "providers": {
    "vivgrid": {
      "baseUrl": "https://api.vivgrid.com/v1",
      "apiKey": "viv-xxxxxxxxxxxxx",
      "api": "openai-completions",
      "compat": {
        "sendSessionAffinityHeaders": true
      },
      "models": [
        {
          "id": "gemini-4-hydrogen",
          "input": ["text", "image"],
          "contextWindow": 1048576,
          "maxTokens": 65536
        }
      ]
    }
  }
}

Make it the model Pi starts with in ~/.pi/agent/settings.json:

~/.pi/agent/settings.json
{
  "defaultProvider": "vivgrid",
  "defaultModel": "gemini-4-hydrogen"
}

Then verify and start Pi:

pi --list-models vivgrid
pi

Or run a one-shot prompt without entering the TUI:

pi -p "explain the auth flow in this repo" --model vivgrid/gemini-4-hydrogen

See the full Pi tutorial.

API surfaces

The Vivgrid Console catalogs gemini-4-hydrogen on 2 surfaces, all behind the same API key. The endpoint shown is the one the Console previews for that surface.

SurfacePrimary endpointUse it for
Chat Completions/chat/completionsAgent projects, where Vivgrid injects the model, system prompt and tools server-side, and Model API calls that name the model per request.
Vibe coding/chat/completionsCoding CLIs and IDE agents that drive the model themselves — point the tool at Vivgrid and keep your own loop.

Quick start

Get an API key from the Vivgrid Console, then call gemini-4-hydrogen directly.

curl https://api.vivgrid.com/v1/chat/completions \
  -H "Authorization: Bearer $VIVGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-hydrogen",
    "messages": [
      { "role": "user", "content": "Say hello in English, Chinese and Spanish." }
    ],
    "stream": true
  }'

Choosing within the Gemini family

Prices are USD per 1M tokens at the base rate. Rows marked this page are the model described here.

ModelContextMax outputInputOutput
gemini-4-carbon1,048,57665,536$4.00$20.00
gemini-4-argon1,048,5761,048,576$4.00$20.00
gemini-4-neon1,048,57665,536$3.00$15.00
gemini-4-hydrogen — this page1,048,57665,536$1.50$7.50
gemini-3.8-flash1,000,000128,000$0.75$3.75

Ideal use cases

  • Everyday coding assistance and high-volume agent traffic
  • Fast tool-calling loops in agentic enterprise workflows
  • Low-cost multimodal summarization and extraction across documents, images, video, and audio
  • Long-context work up to ~1M tokens on a budget
  • gemini-4-neon — more capable Gemini 4 model, still tuned for low latency
  • gemini-4-carbon — Google's frontier Gemini 4 model, which Hydrogen is adapted from
  • gemini-3.8-flash — Google's fast Gemini Flash model at a lower price

On this page