Models

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

gemini-4-carbon on Vivgrid: Google's frontier Gemini 4 model for deep work on complex, real-world tasks, with a 1M-token context window, 64K max output, and text, image, video, audio, and PDF input.

gemini-4-carbon is Google's frontier model in the Gemini 4 series, built for deep work on complex, real-world tasks: long-horizon agentic coding, multi-step research, and analysis across large codebases and document sets. 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-carbon 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-carbon
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
$4.00$0.20$20.00

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.1200
Warm prompt, 90% of the input served from cache$0.0516

Input is priced at $4.00 per 1M tokens (one rate for text, image, video, and audio), cached input at $0.20 per 1M tokens, and output (including thinking tokens) at $20.00 per 1M tokens, with a single flat rate across the full context window — the same rates as gemini-4-argon.

Use gemini-4-carbon in your coding agent

gemini-4-carbon 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-carbon 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-carbon 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-carbon",
  "provider": {
    "vivgrid": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Vivgrid",
      "options": {
        "baseURL": "https://api.vivgrid.com/v1",
        "apiKey": "{env:VIVGRID_API_KEY}"
      },
      "models": {
        "gemini-4-carbon": {
          "name": "gemini-4-carbon",
          "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-carbon 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-carbon 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-carbon",
          "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-carbon"
}

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-carbon

See the full Pi tutorial.

API surfaces

The Vivgrid Console catalogs gemini-4-carbon 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-carbon directly.

curl https://api.vivgrid.com/v1/chat/completions \
  -H "Authorization: Bearer $VIVGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-carbon",
    "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-carbon — this page1,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-hydrogen1,048,57665,536$1.50$7.50
gemini-3.8-flash1,000,000128,000$0.75$3.75

Ideal use cases

  • Deep work on complex, real-world tasks that need sustained multi-step reasoning
  • Long-horizon autonomous coding agents working across large codebases
  • Multimodal analysis of documents, images, video, and audio up to ~1M tokens
  • Research and planning workflows where answer quality matters more than latency
  • gemini-4-neon — lower-latency, lower-cost Gemini 4 model adapted from Carbon
  • gemini-4-hydrogen — the fastest, lowest-cost Gemini 4 model
  • gemini-4-argon — Google's flagship Gemini 4 reasoning model at the same price

On this page