APIMODELSAPIMODELS

How to use Gemini 4 Carbon

TL;DR Gemini 4 Carbon (model id gemini-4-carbon) is Google’s deeper-reasoning Gemini 4 model, on the Gemini API for every paid developer since 10 November 2026. You can use it in the Gemini app with Google AI Ultra, in AI Studio and the Gemini API on the paid tier, in GitHub Copilot (Pro+, Max, Business and Enterprise), in Cursor and in Google Antigravity, or through an API gateway such as apimodels.app, which works from mainland China and charges $1.10 / $5.50 per 1M tokens through 30 November. It is not on the free tier, Gemini CLI is not tuned for it yet, and Google’s API does not serve mainland China. Carbon thinks for a long time, so raise the output limit to at least 32,768 tokens, allow 15-minute timeouts and stream long answers. It does best on long, hard jobs and tends to overstate what it finished, so check its work.

Model page: Gemini 4 Carbon API — pricing, specs and the playground

Most of the questions people search about Carbon are practical: where it is available, why it does not show up or times out, whether it works from China, and what it costs. This page answers those first, then shows what developers have actually built with it and the prompting habits that worked.

We run apimodels.app, one of the places you can call Carbon. Availability, limits and benchmark figures below come from Google’s documentation and from third-party pages read on 12 November 2026; the examples are other people’s public work, credited and linked. We have not run our own benchmark.

Where you can use Gemini 4 Carbon

Carbon is available in Google’s own products, in two big coding tools and on the API. Google limits the consumer apps to its top AI Ultra plan; developers need the paid tier of the Gemini API, because Carbon is not on the free tier.

WhereWho can use itNotes
Gemini app and AI Mode in SearchGoogle AI Ultra subscribersChat use; no API key needed
Google AI Studio and the Gemini APIPaid tier onlyModel id gemini-4-carbon; Google lists $2 / $10 per 1M tokens through 30 Nov, $4 / $20 from 1 Dec
Google AntigravityAI Ultra subscribers and enterprisesThe agent IDE most testers on this page used; runs count against the subscription quota
Gemini for business and Google CloudEnterprisesGA on 10 Nov 2026; a cyber variant is limited to Google’s Fairwind program
GitHub CopilotPro+, Max, Business and Enterprise plansVS Code, Visual Studio, JetBrains, Xcode, Copilot CLI and more; billed at provider list pricing; gradual rollout
CursorCursor users200K context by default, up to 1M; three effort levels, medium by default
apimodels.appAnyone with a key, including mainland China$1.10 / $5.50 per 1M tokens through 30 Nov, $2.20 / $11 from 1 Dec; OpenAI-compatible and native Gemini endpoints
Gemini CLINot yetThe README says it is not tuned for the Gemini 4 series; the request to support Carbon was still open on 12 Nov

Why Gemini 4 Carbon may not work for you

No free tier. Google does not offer Carbon on the Gemini API free tier, so a free AI Studio key cannot use it. Turn on billing or use a paid gateway.

Not in your Gemini app. In the consumer apps Carbon is only for Google AI Ultra subscribers; other plans do not see it.

Region. Google’s list of regions for the Gemini API and AI Studio does not include mainland China, Hong Kong or Macao.

Gemini CLI. Gemini CLI is not tuned for the Gemini 4 series yet. Use Antigravity, Copilot, Cursor, or any agent that can call an OpenAI-compatible or Gemini endpoint.

Timeouts and cut-off answers. Carbon can think for minutes before it writes anything; Artificial Analysis measured about 68 seconds to the first answer token on average. Short client timeouts end the request first, and a low output limit can be used up by thinking, because the limit covers thinking plus the answer. Google recommends at least 32,768 output tokens and HTTP timeouts of 15 minutes or more, and its model card warns of occasional slowness and timeouts.

Subscription quota. Agent runs in Antigravity draw on the AI Ultra quota. One developer running four parallel sessions used up a $99.99 Ultra window in about two hours.

How to call it, and the settings that matter

On apimodels.app, call gemini-4-carbon with the same key you use for every other model: POST https://api.apimodels.app/v1/chat/completions in OpenAI format, or POST https://api.apimodels.app/v1beta/models/gemini-4-carbon:generateContent in native Gemini format. No Google Cloud project or overseas card is needed, and it works from mainland China without a proxy; top up with Alipay, PayPal, a card or USDT.

Thinking level. Carbon has three levels, low, medium and high, with medium as the default. Pass reasoning_effort on the OpenAI-compatible endpoint, or generationConfig.thinkingConfig.thinkingLevel on the native one. Higher levels spend more tokens and take longer to start.

Output limit and timeouts. Set max output to at least 32,768 tokens, give your HTTP client a 15-minute timeout, and stream long answers. Outputs beyond 65,536 tokens need Google’s long-decode mode.

Parameters it ignores. temperature, top_p and top_k have no effect on Carbon; remove them. Explicit context caching is not supported either; repeated prefixes of 4,096 tokens or more are cached implicitly.

Inputs. Carbon reads text, images, video, audio and PDFs in one request, with a 1,048,576-token context shared by input and output.

What people have built with Gemini 4 Carbon

Carbon’s public showcase is long, self-directed builds: games, 3D scenes and simulations that an agent works on for an hour or more. A few examples, all by other people and linked to their posts; the full credited list is in our Gemini 4 Carbon case library, linked at the end of this page.

A cozy diorama builder in one HTML file. FireTable ran Carbon in Antigravity’s multi-agent /swarm mode from a one-line Chinese prompt: 1 hour 41 minutes, 9 agents, 22,910 lines with no merge conflicts, procedural stone walls, 195,000 blades of GPU grass and WebAudio, shipped as a single 930 KB file.

A game rebuilt from a video, with its own bug checks. One creator gave Carbon in Antigravity the gameplay video of a 3D shooter that Claude Fable 5.2 had built in an 8-hour run and asked for the same game or better. In 48 minutes and $3.82 it produced a single 638.5 KB HTML file, and a headless-Chrome screenshot loop caught and fixed three bugs on its own. Another creator, through Vertex AI, got a playable Mario-style 3D platformer of 2,599 lines from one shot, at a reported $0.45.

Fifteen projects with every prompt published. The creator 亚里 ran 15 builds in Antigravity at high thinking, from a Counter-Strike Dust2 remake to a video editor and a rabies explainer, and published each prompt. A Minecraft-style sunset scene took Carbon one 32-minute pass where Argon had needed six rounds over about 2 hours 18 minutes. His conclusion: Carbon handles long tasks well, its visual taste is average, and one-line wishes rarely work.

Fixing what a person could not. A Hacker News user had Carbon reverse-engineer a fishing game’s data files to change spawn and hook rules, something he had failed to do for four years, and published the whole session. Another developer had it review an unfinished paper draft and reported that it raised points every other model missed.

Research. A Google DeepMind researcher reported that teams of Carbon agents found new exact solutions to the differential equations of nuclear fusion devices, the post with the most likes in our collection.

Science and simulation. A developer had Carbon write a pure CUDA and C++20 ray tracer of 65,536 raindrops falling on a lotus pond, with physics and procedural audio; another rebuilt a 181-part Song Dynasty timber pavilion with an exploded view and an ink-painting shader.

How to prompt it

Spell out the job instead of making a wish. Testers who gave Carbon one vague line got average results; the builds that worked named the stack, the deliverable and what done looks like. KostiKoNeuro’s winning racer prompt, for example, names the game, the era and the feeling, asks for music and sound in code, one index.html with libraries from a CDN, and ends with “Don’t ask questions: build it, play it yourself, fix what’s broken.”

Make it test the result, not just its own unit tests. In AICodeKing’s six builds, every one of Carbon’s final summaries overstated at least one feature, and it had only run its own tests. Ask it to open the app in a browser, click through the main flow and report what it saw.

Budget time and tokens. Carbon is slow and verbose by design: about 30 minutes per fix in one real-code test, a third more output than Argon and four times Fable 5.2’s. Run it in the background or in parallel, and cap spend with max output and a stop condition.

Use high thinking only where it pays. Medium is the default and is enough for most of the cases on this page; Cursor’s benchmark found Carbon at medium within 0.3 points of high at lower cost.

What Gemini 4 Carbon costs

Carbon has the same per-token price as Gemini 4 Argon. Per job it varies widely, because the thinking tokens are billed as output. Published examples: $0.56 per try on a hard Sudoku at high thinking; $2.12 per task on Zapier’s AutomationBench and $9.22 on CursorBench at list price; about $23 for six full app builds in AICodeKing’s test; and $27.68 for three long builds in AI for Mortals’ test, where Claude Fable 5.2 cost $883.30 for the same three.

Per 1M tokensGoogle listapimodels.app
Input$2 ($4 from 1 Dec)$1.10 ($2.20 from 1 Dec)
Output, including thinking$10 ($20 from 1 Dec)$5.50 ($11 from 1 Dec)
Cached input$0.10 ($0.20 from 1 Dec)$0.055 ($0.11 from 1 Dec)

When not to use Gemini 4 Carbon

Interactive coding and everyday edits: use Gemini 4 Argon. Google recommends it for most software engineering, it answers sooner, and it costs the same per token; the full comparison is linked below.

Short, high-volume requests: neither Gemini 4 model; Gemini 3.8 Flash is $0.45 / $2.25 per 1M tokens on apimodels.app.

When the result must be right and you cannot check it: Claude Fable 5.2 scored higher in most hands-on tests and on Artificial Analysis (65 against 60), at a much higher cost per task; that comparison is linked below too.

Polished front-end design: several testers found Carbon’s UI work average next to its 3D and long-task results.

Sources

Read on 12 November 2026. Google: the Gemini 4 Carbon announcement, the Gemini API docs, pricing and available regions, and the model card. Tools: GitHub’s Copilot changelog, Cursor’s model docs and the Gemini CLI repository. Examples and costs: the creators’ own posts, linked from the case library.

Inicio rápido

Native Gemini format (thinking level, output limit)

curl -N https://api.apimodels.app/v1beta/models/gemini-4-carbon:streamGenerateContent?alt=sse \
  -H "x-goog-api-key: $APIMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Find the root cause of this flaky test: ..."}]}],
    "generationConfig": {
      "maxOutputTokens": 32768,
      "thinkingConfig": {"thinkingLevel": "high"}
    }
  }'

cURL

curl https://api.apimodels.app/v1/chat/completions \
  -H "Authorization: Bearer $APIMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 900 \
  -d '{
    "model": "gemini-4-carbon",
    "reasoning_effort": "medium",
    "max_tokens": 32768,
    "stream": true,
    "messages": [{"role": "user", "content": "Build a single-file three.js scene of ... Open it in a browser, check it works, then report what you saw."}]
  }'

Preguntas frecuentes

How do I use Gemini 4 Carbon?

Use Gemini 4 Carbon in the Gemini app with a Google AI Ultra plan, or call the model id gemini-4-carbon on the paid Gemini API, in AI Studio, GitHub Copilot (Pro+, Max, Business, Enterprise), Cursor or Antigravity. Through apimodels.app it is one more model on an OpenAI-compatible key: POST /v1/chat/completions with model gemini-4-carbon. Raise the output limit to 32,768 tokens or more and allow long timeouts, because it thinks for a while before answering.

Is Gemini 4 Carbon free?

No. Gemini 4 Carbon is not on the Gemini API free tier, and in the consumer apps it needs Google AI Ultra. On the API Google charges $2 per 1M input tokens and $10 per 1M output through 30 November 2026 and $4 / $20 from 1 December; apimodels.app charges $1.10 / $5.50, then $2.20 / $11.00, and failed requests are not billed.

Why can’t I use Gemini 4 Carbon?

The usual reasons are a free-tier key (Carbon is paid only), a Gemini app plan below AI Ultra, an unsupported region (the Gemini API does not serve mainland China, Hong Kong or Macao), using Gemini CLI (not tuned for Gemini 4 yet) or a client timeout shorter than Carbon’s thinking time. Fix the one that applies: a paid key or gateway, Antigravity, Copilot or Cursor instead of the CLI, and timeouts of 15 minutes with streaming.

Can I use Gemini 4 Carbon from mainland China?

Not directly from Google: its Gemini API and AI Studio regions list does not include mainland China. Through apimodels.app Carbon works from mainland China today without a proxy: sign up, create a key, top up with Alipay, PayPal, a card or USDT, and call gemini-4-carbon on api.apimodels.app in OpenAI or native Gemini format.

Can I use Gemini 4 Carbon in GitHub Copilot or Cursor?

Yes. GitHub made Carbon generally available in Copilot on 10 November 2026 for the Pro+, Max, Business and Enterprise plans, billed at provider list pricing, across VS Code, Visual Studio, JetBrains, Xcode and the Copilot CLI. Cursor lists gemini-4-carbon with a 200K default context, up to 1M, and medium effort by default.

Does Gemini CLI support Gemini 4 Carbon?

Not yet. The Gemini CLI README says it is not tuned for the Gemini 4 series, and the issue asking for Carbon support was still open on 12 November 2026. For an agent that runs Carbon today, use Google Antigravity, GitHub Copilot’s CLI or coding agent, Cursor, or an OpenAI-compatible agent pointed at a gateway that serves gemini-4-carbon.

Relacionado

Aparece en
APIMODELS on Product HuntAPIMODELS featured on ToolifyAPIMODELS featured on There's An AI For That