Changer la chaîne du modèle pour gemini-4-carbon ne termine pas la requête. Le 10 novembre 2026, Google a ouvert Gemini 4 Carbon sur l'API Gemini payante, dans Google AI Studio, et pour les abonnés AI Ultra dans Antigravity. Le prix d'introduction jusqu'au 30 novembre est de 2 $ par million de jetons d'entrée et 10 $ par million de jetons de sortie ; la sortie inclut les jetons de thinking. À partir du 1er décembre, ces tarifs passent à 4 $ et 20 $. Les hits du cache implicite sont à moins 95 % (0,10 $, puis 0,20 $). Carbon n'est pas sur l'offre gratuite.
Cette page est datée du 13 novembre 2026, d'après le guide du 10 novembre et la page What's new. Il y a trois jours, nous traitions effort et usage de Fable 5.2. Les réglages de Carbon sont sur l'API Interactions : generation_config.thinking_level, background et usage.
Ce qui s'est ouvert le 10 novembre
Google présente Carbon comme son modèle de raisonnement le plus fort pour l'ingénierie longue, les fichiers multimodaux denses et le travail scientifique. L'identifiant est gemini-4-carbon. Le niveau de pensée par défaut est medium. Entrée, thinking et sortie partagent une fenêtre de 1 048 576 jetons. Une réponse synchrone s'arrête à 65 536 jetons tant que le décodage long n'est pas activé.
gemini-4-argon partage cette fenêtre, les mêmes valeurs de thinking_level, les outils intégrés et le même prix d'introduction. Carbon dépense plus de jetons de thinking par tour. Gardez Argon pour le code interactif. Envoyez à Carbon les causes racines, l'architecture et les boucles de vérification.
| Fenêtre | Entrée / 1 M | Sortie, thinking compris / 1 M | Entrée en cache / 1 M |
|---|---|---|---|
| Jusqu'au 30 novembre 2026 | 2 $ | 10 $ | 0,10 $ |
| À partir du 1er décembre 2026 | 4 $ | 20 $ | 0,20 $ |
JSON de requête et thinking_level
POST vers https://generativelanguage.googleapis.com/v1beta/interactions avec x-goog-api-key et Content-Type: application/json. La profondeur est generation_config.thinking_level, pas un budget numérique.
{
"model": "gemini-4-carbon",
"input": "Analyze this payment pipeline for race conditions during retries and rewrite the locks.",
"generation_config": {
"thinking_level": "medium"
}
}
| thinking_level | Usage indiqué par le guide Carbon |
|---|---|
| low | Routage, classement, extraction ciblée |
| medium | Défaut. La plupart des tours de code et d'agent |
| high | Cause racine, maths formelles, architecture |
Sans thinking_level, le serveur prend medium. Le guide Carbon documente low, medium et high. L'énumération Interactions commune liste aussi minimal et xhigh pour d'autres modèles ; ne les envoyez pas tant que la page Carbon ne les cite pas. thinking_budget est déprécié et renvoie un avertissement. max_output_tokens plafonne thinking et texte visible ensemble. Un plafond trop bas coupe la réponse avant la fin du raisonnement.
background et décodage long
Pour dépasser 65 536 jetons, mettez background à true au premier niveau et max_output_tokens au-dessus de 65536. Le plafond est 1 048 576 moins l'entrée. background: true sans max_output_tokens s'arrête encore à 64K.
{
"model": "gemini-4-carbon",
"input": "Write a complete proof of the prime number theorem.",
"background": true,
"generation_config": {
"thinking_level": "high",
"max_output_tokens": 262144
}
}
Le guide Carbon interroge tant que status vaut in_progress ou queued. La ressource Interaction connaît aussi completed, failed, cancelled, incomplete, requires_action et requires_continuation. incomplete signifie que le plafond est atteint. En HTTP, lisez l'id avec GET /v1beta/interactions/{id}. L'exemple de fond du guide de démarrage envoie l'en-tête Api-Revision: 2026-05-20 sur ce GET.
Chaque saut de décodage long ajoute un élément steps[] de type: model_output. Concaténez chaque partie texte. Lire seulement steps[0] laisse tomber le reste. previous_interaction_id prolonge l'historique et ne rejoue pas generation_config, les tools ni system_instruction ; renvoyez thinking_level à l'appel suivant. store vaut true par défaut (l'offre payante garde les interactions 55 jours). store: false ne se combine pas avec background: true.
Champs à retirer d'un ancien JSON Gemini
En venant de Gemini 3 ou d'avant, What's new et le guide demandent de changer le JSON, pas seulement l'identifiant :
temperature,top_pettop_ksont ignorés. Le guide parle d'un avertissement de dépréciation.- Retirez
cached_contentexplicite etcaches.create. Le cache implicite commence à 4 096 jetons et réduit les hits de 95 %. - Remplacez
thinking_budgetparthinking_level. - Si
max_output_tokensest sous 32 768, montez-le au moins à 32 768. Pour moins de jetons, baissez le niveau de pensée. - Les prompts durs peuvent prendre plusieurs minutes. Utilisez background, ou un délai HTTP d'au moins 15 minutes.
Votre propre schéma JSON reste sur les champs de schéma de réponse. Voir JSON structuré avec l'API Gemini et ce qu'est la sortie structurée. Carbon ne transforme pas un jugement en probabilités ; c'est un autre point d'accès.
usage avant le prix du 1er décembre
Une interaction terminée porte usage. Dans l'échantillon publié, 7 jetons d'entrée + 20 de sortie + 22 de thought égalent total_tokens 49. total_thought_tokens n'est donc pas inclus dans total_output_tokens.
{
"id": "v1_example",
"object": "interaction",
"model": "gemini-4-carbon",
"status": "completed",
"steps": [
{
"type": "model_output",
"content": [{ "type": "text", "text": "..." }]
}
],
"usage": {
"total_input_tokens": 7,
"total_cached_tokens": 0,
"total_output_tokens": 20,
"total_thought_tokens": 22,
"total_tool_use_tokens": 0,
"total_tokens": 49,
"input_tokens_by_modality": [{ "modality": "text", "tokens": 7 }]
}
}
Facturez l'entrée non cachée au tarif d'entrée, total_cached_tokens à 5 % de ce tarif, et total_output_tokens plus total_thought_tokens au tarif de sortie. N'ajoutez pas aussi total_tokens. Les requêtes Grounding restent facturées à part, et les consignes d'outils comptent comme jetons traités. Conservez l'objet usage entier pour appliquer le prix du 1er décembre aux journaux déjà écrits.
Routage Argon et agent_config
Exprimez la séparation dans la config. Argon reste sur le chemin rapide au même prix affiché ; Carbon prend les tours qui dépensent des jetons de thinking.
{
"routes": [
{ "if": { "task": "interactive_coding" }, "model": "gemini-4-argon", "thinking_level": "medium" },
{ "if": { "task": "root_cause" }, "model": "gemini-4-carbon", "thinking_level": "high", "background": true }
]
}
Les agents gérés placent le modèle dans agent_config. generation_config s'applique quand model est défini ; agent_config est l'autre voie.
{
"agent": "antigravity-preview-09-2026",
"environment": "remote",
"input": "Audit the site for Core Web Vitals and return a scorecard.",
"agent_config": {
"type": "antigravity",
"model": "gemini-4-carbon"
}
}
JSON à vérifier avant la mise en ligne
- Le corps a
gemini-4-carbon, unthinking_levellow, medium ou high, et nitemperature, nitop_p, nitop_k, nithinking_budget, nicached_content. - Tout appel qui doit dépasser 64K pose
background: trueetmax_output_tokensau-dessus de 65536. - L'analyseur concatène chaque texte
model_outputet notestatus. - La facture sépare entrée, entrée en cache, sortie et jetons de thought, avec les tarifs du 1er décembre prêts.
Vérifiez en local avec le validateur JSON, JSONPath ($.usage.total_thought_tokens) et JSON Diff contre la requête précédente. Rien n'est envoyé.
FAQ
gemini-4-carbon est-il sur l'offre gratuite ?
Non. What's new le réserve à l'offre payante. Le prix d'introduction 2 $/10 $ court jusqu'au 30 novembre 2026, puis 4 $/20 $.
Puis-je envoyer thinking_level xhigh ?
Le guide Carbon documente low, medium et high. minimal et xhigh figurent dans l'énumération Interactions pour d'autres modèles. Ne copiez pas les valeurs d'effort de Claude dans ce champ.
Pourquoi la réponse s'arrête-t-elle à 64K jetons ?
Les réponses synchrones s'arrêtent à 65 536. Mettez background à true et max_output_tokens au-dessus de 65536. background seul reste à 64K. status incomplete signifie que le plafond est atteint.
La facture doit-elle utiliser total_tokens ?
Non. Entrée non cachée au tarif d'entrée, total_cached_tokens à 5 %, total_output_tokens plus total_thought_tokens au tarif de sortie. Ajouter total_tokens compte deux fois.
previous_interaction_id conserve-t-il thinking_level ?
Non. Renvoyez generation_config, tools et system_instruction à l'interaction suivante. L'id conserve l'historique.
Puis-je garder un cache de contexte explicite ?
Non. Retirez cached_content. Le cache implicite s'applique dès 4 096 jetons et réduit les hits de 95 %.
En bref
Carbon, ouvert le 10 novembre 2026, change la durée de réflexion du modèle et ce que vous payez après le 30 novembre. Utilisez gemini-4-carbon avec thinking_level à low, medium ou high. Au-delà de 64K, associez background: true à un max_output_tokens supérieur à 65536. Facturez les jetons de thought à part de la sortie visible, et retirez les champs d'échantillonnage et les caches explicites avant l'envoi.