Замена строки модели на gemini-4-carbon не заканчивает запрос. 10 ноября 2026 года Google открыл Gemini 4 Carbon в платной Gemini API, в Google AI Studio и для подписчиков AI Ultra в Antigravity. Вводная цена до 30 ноября: $2 за миллион входных токенов и $10 за миллион выходных; выход включает токены thinking. С 1 декабря ставки становятся $4 и $20. Попадания неявного кэша дешевле на 95 процентов ($0.10, затем $0.20). Carbon нет на бесплатном уровне.
Страница датирована 13 ноября 2026 года по руководству от 10 ноября и странице What's new. Три дня назад мы разбирали effort и usage у Fable 5.2. Рычаги Carbon лежат в Interactions API: generation_config.thinking_level, background и usage.
Что открылось 10 ноября
Google называет Carbon самой сильной моделью рассуждения для длинной инженерии, плотных мультимодальных файлов и научной работы. Идентификатор — gemini-4-carbon. Уровень мышления по умолчанию — medium. Вход, thinking и выход делят одно окно в 1 048 576 токенов. Синхронный ответ останавливается на 65 536 токенах, пока не включён длинный вывод.
gemini-4-argon делит это окно, те же значения thinking_level, встроенные инструменты и ту же вводную цену. Carbon тратит больше токенов thinking на ход. Интерактивный код оставляйте на Argon. Корневую причину, архитектуру и циклы проверки отдавайте Carbon.
| Период | Вход / 1 млн | Выход, включая thinking / 1 млн | Кэш входа / 1 млн |
|---|---|---|---|
| До 30 ноября 2026 | $2 | $10 | $0.10 |
| С 1 декабря 2026 | $4 | $20 | $0.20 |
JSON запроса и thinking_level
POST на https://generativelanguage.googleapis.com/v1beta/interactions с заголовками x-goog-api-key и Content-Type: application/json. Глубина задаётся в generation_config.thinking_level, а не числовым бюджетом.
{
"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 | Для чего его называет руководство Carbon |
|---|---|
| low | Маршрутизация, классификация, точечное извлечение |
| medium | По умолчанию. Большинство ходов кода и агента |
| high | Поиск причины, формальная математика, архитектура |
Если thinking_level нет, сервер берёт medium. Руководство Carbon документирует low, medium и high. Общее перечисление Interactions также содержит minimal и xhigh для других моделей; не отправляйте их, пока страница Carbon их не назовёт. thinking_budget устарел и возвращает предупреждение. max_output_tokens ограничивает thinking и видимый текст вместе. Низкий потолок обрежет ответ до конца рассуждения.
background и длинный вывод
Чтобы выйти за 65 536 токенов, поставьте background в true на верхнем уровне и max_output_tokens выше 65536. Потолок — 1 048 576 минус вход. background: true без max_output_tokens всё равно останавливается на 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
}
}
Руководство Carbon опрашивает, пока status равен in_progress или queued. Ресурс Interaction также использует completed, failed, cancelled, incomplete, requires_action и requires_continuation. incomplete значит, что потолок достигнут. По HTTP id читается GET /v1beta/interactions/{id}. Пример фона во вводном руководстве шлёт на этот GET заголовок Api-Revision: 2026-05-20.
Каждый шаг длинного вывода добавляет элемент steps[] с type: model_output. Склейте все текстовые части. Чтение только steps[0] отбрасывает остальное. previous_interaction_id продолжает историю и не повторяет generation_config, tools и system_instruction; thinking_level отправьте снова в следующем вызове. store по умолчанию true (платный уровень хранит interactions 55 дней). store: false нельзя сочетать с background: true.
Поля, которые надо убрать из старого JSON Gemini
При переходе с Gemini 3 и старше What's new и руководство просят менять JSON, а не только id модели:
temperature,top_pиtop_kигнорируются. Руководство говорит, что они возвращают предупреждение об устаревании.- Уберите явный
cached_contentиcaches.create. Неявный кэш начинается с 4 096 токенов и даёт 95 процентов скидки на попадания. - Замените
thinking_budgetнаthinking_level. - Если
max_output_tokensниже 32 768, поднимите его хотя бы до 32 768. Меньше токенов даёт более низкий уровень мышления. - Тяжёлые запросы могут занимать минуты. Используйте background или таймаут HTTP не меньше 15 минут.
Собственная JSON Schema остаётся в полях схемы ответа. См. структурированный JSON в Gemini API и что такое структурированный вывод. Carbon не превращает суждение в вероятности; для этого другой endpoint.
usage до цены 1 декабря
Завершённая interaction несёт usage. В опубликованном примере 7 входных + 20 выходных + 22 thought дают total_tokens 49, значит total_thought_tokens не входит в 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 }]
}
}
Некэшированный вход — по входной цене, total_cached_tokens — по 5 процентам этой цены, total_output_tokens плюс total_thought_tokens — по выходной. Не прибавляйте ещё total_tokens. Запросы Grounding тарифицируются отдельно, инструкции инструментов тоже считаются обработанными токенами. Храните весь объект usage, чтобы цена 1 декабря легла на уже собранные журналы.
Маршрут Argon и agent_config
Разведите модели в конфигурации. Argon остаётся на быстром пути по той же цене прайса; Carbon берёт ходы, которые тратят токены 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 }
]
}
Управляемые агенты кладут модель в agent_config. generation_config действует, когда задан model; agent_config — другой путь.
{
"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, который проверить перед запуском
- В теле стоит
gemini-4-carbon,thinking_levelравен low, medium или high, и нетtemperature,top_p,top_k,thinking_budget,cached_content. - Вызов, которому нужно больше 64K, задаёт
background: trueиmax_output_tokensвыше 65536. - Разбор склеивает каждый текст
model_outputи сохраняетstatus. - Счёт разделяет вход, кэш входа, выход и токены thought и готов к ставкам 1 декабря.
Проверьте локально валидатором JSON, JSONPath ($.usage.total_thought_tokens) и JSON Diff с предыдущим запросом. Ничего не загружается.
FAQ
gemini-4-carbon есть на бесплатном уровне?
Нет. What's new ограничивает его платным уровнем. Вводная цена $2/$10 действует до 30 ноября 2026 года, затем $4/$20.
Можно ли отправить thinking_level xhigh?
Руководство Carbon документирует low, medium и high. minimal и xhigh есть в общем перечислении Interactions для других моделей. Не копируйте значения effort Claude в это поле.
Почему ответ останавливается на 64K токенов?
Синхронные ответы останавливаются на 65 536. Поставьте background в true и max_output_tokens выше 65536. Один background всё ещё останавливается на 64K. status incomplete значит, что потолок достигнут.
Считать ли счёт по total_tokens?
Нет. Некэшированный вход по входной цене, total_cached_tokens по 5 процентам, total_output_tokens плюс total_thought_tokens по выходной. Добавление total_tokens считает дважды.
previous_interaction_id сохраняет thinking_level?
Нет. Повторно отправьте generation_config, tools и system_instruction в следующей interaction. Идентификатор хранит историю.
Можно ли оставить явный кэш контекста?
Нет. Уберите cached_content. Неявный кэш действует от 4 096 токенов и даёт 95 процентов скидки на попадания.
Итог
Carbon, открытый 10 ноября 2026 года, меняет, как долго модель думает и сколько вы платите после 30 ноября. Используйте gemini-4-carbon с thinking_level low, medium или high. Если ответ должен превысить 64K, сочетайте background: true с max_output_tokens выше 65536. Считайте токены thought отдельно от видимого выхода и уберите поля сэмплирования и явные кэши до отправки.