После открытия Gemini 4 Carbon 10 ноября: как в JSON Interactions задать thinking_level, background и usage до смены цены 1 декабря?

Только платный уровень. До 30 ноября $2/$10, затем $4/$20. thinking_level — low, medium или high; длинный вывод требует background и большего max_output_tokens.

Замена строки модели на 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, который проверить перед запуском

  1. В теле стоит gemini-4-carbon, thinking_level равен low, medium или high, и нет temperature, top_p, top_k, thinking_budget, cached_content.
  2. Вызов, которому нужно больше 64K, задаёт background: true и max_output_tokens выше 65536.
  3. Разбор склеивает каждый текст model_output и сохраняет status.
  4. Счёт разделяет вход, кэш входа, выход и токены 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 отдельно от видимого выхода и уберите поля сэмплирования и явные кэши до отправки.