Сколько стоит задача в Gemini 4 Carbon API: расчёт полной стоимости
Рассчитайте стоимость задачи Gemini 4 Carbon с проверенным Python-калькулятором: текущие и декабрьские тарифы, кэш, рассуждения, повторы, шаги агента и отдельная плата за инструменты.
Чтобы оценить стоимость задачи Gemini 4 Carbon, сложите известные расходы по каждой отдельной попытке и каждому шагу продолжения: вход без попадания в кэш, вход из кэша, сгенерированные токены вместе с рассуждениями и отдельно оплачиваемые инструменты. Сначала выберите период действия тарифа. Видимый итоговый ответ отражает лишь часть этих расходов. Повторная попытка или предыдущий шаг агента могут потреблять ресурсы, даже если не дали принятого результата.
В статье есть полный скачиваемый калькулятор на Python, единый формат входных данных и воспроизводимые примеры. Используются тарифы Google Standard в долларах США для gemini-4-carbon, проверенные 15 ноября 2026 года. Они не относятся к Batch, Flex, Priority, индивидуальным договорам или маршрутам Ofox. Если сначала нужно получить рабочий ответ API, начните с инструкции по подключению Carbon.
Статью публикует Ofox. Калькулятор и CLI прошли 24 офлайн-теста. Количество токенов и результаты задач во всех примерах заданы условно: это не измерения модели и не счёт поставщика. Набор не вызывает API, не загружает ключ и не интерпретирует автоматически исходный usage провайдера. Его назначение — воспроизводимо считать реестр с подтверждённым смыслом показателей и выявлять типичные ошибки учёта.
Выберите точную модель, уровень обслуживания и дату тарифа
В таблице цен Carbon от Google (на английском) указаны следующие тарифы Standard. Все ставки даны в долларах США за миллион токенов, а не за запрос или принятую задачу.
| Категория | До 30 ноября 2026 года включительно | С 1 декабря 2026 года | К какому объёму применяется |
|---|---|---|---|
| Обычный вход | $2,00 | $4,00 | Входные токены без попадания в кэш |
| Кэшированный вход | $0,10 | $0,20 | Фактически попавшая в кэш часть входа |
| Выход, включая рассуждения | $10,00 | $20,00 | Подтверждённый совокупный оплачиваемый объём генерации |
На дату проверки декабрьский столбец — будущий сценарий, а не текущая цена. При одинаковом количестве токенов эти три ставки удваиваются. Отдельная плата за инструменты не обязана удваиваться вместе с ними. Google не указывает для Carbon уровень Free; наличие льготного лимита инструмента не делает обработку токенов Carbon бесплатной.

Реальный снимок англоязычной официальной страницы цен. Оставлен только участок Standard со ставками токенов, без сведений об аккаунте. Это источник цен, а не счёт и не предложение Ofox.
Храните вместе ID модели, уровень обслуживания, валюту, единицу и период действия цены. Ставки соседней модели Gemini или другого уровня недостаточно для расчёта запроса Carbon. В руководстве по выбору моделей Google рассматривается соответствие задачам; эта статья не доказывает, что Carbon — самый дешёвый способ получить эквивалентный результат.
Некоторые инструменты Google оплачиваются отдельно. В описании Search grounding отмечено, что один клиентский запрос может породить несколько поисковых запросов, и именно эти запросы имеют значение для оплаты инструмента. Общие льготные лимиты и ограничения нужно сверять с актуальным разделом цен инструментов. Не умножайте фиксированную плату на число запросов приложения, если это не реальная единица тарификации. Калькулятор принимает известную отдельную сумму в USD, а не предполагаемое число вызовов инструмента.
Приведите usage к единому смыслу до применения формулы
В реестре используются наши собственные имена полей, а не имена полей ответа Google или Ofox. Прежде чем подставлять реальные значения, изучите контракт конкретного эндпоинта, версии SDK и режима выполнения. Исходную запись usage сохраните приватно, чтобы можно было объяснить преобразование.
| Поле реестра | Требуемый смысл | Какой ошибки избегать |
|---|---|---|
id | Уникальный идентификатор отдельно учитываемой попытки или шага продолжения | Повторного учёта одного запроса по разным снимкам состояния |
input_total | Весь оплачиваемый вход строки, включая кэшированную часть | Подмены общего входа показателем, который уже исключает кэш |
cached_input | Известная часть input_total, попавшая в кэш | Предположения, что все подходящие токены обязательно попали в кэш |
generated_including_thinking | Общий оплачиваемый объём генерации, в котором рассуждения учтены один раз | Прибавления рассуждений к значению, уже включающему их |
tools_usd | Известная отдельная плата за инструменты в виде десятичной строки; "0" только при известном нуле | Подмены неизвестной платы или числа токенов инструмента нулём долларов |
В документации Google по подсчёту токенов (на английском) встречаются отдельные показатели total_input_tokens, total_output_tokens, total_thought_tokens, total_cached_tokens и total_tool_use_tokens. Их названия сами по себе не задают универсальное правило соответствия счёту. Проверенные для статьи документы и комментарии SDK не устанавливают одно правило включения рассуждений в выход для всех маршрутов и режимов Carbon.
Преобразование зависит от подтверждённой семантики. Если контракт говорит, что общий выход уже включает рассуждения, используйте эту сумму один раз. Если видимый выход и рассуждения подтверждены как непересекающиеся оплачиваемые объёмы, сложите их один раз для нормализованного поля. Если связь неизвестна, остановитесь и отметьте показатель как неизвестный. Не выбирайте формулу только потому, что результат выглядит правдоподобно. Число токенов использования инструмента также не равно автоматически отдельной денежной плате.
Аналогично выясните, относится ли usage к одному запросу, одному продолжению или накопленному взаимодействию. Не складывайте накопительные снимки потокового ответа. Если итог уже включает предыдущие шаги, используйте итог один раз либо подтверждённые непересекающиеся показатели шагов. Смешивание обоих вариантов завышает стоимость задачи.
После нормализации формула строки проста:
ordinary_input = input_total - cached_input
row_cost_usd = (
ordinary_input * ordinary_input_rate
+ cached_input * cached_input_rate
+ generated_including_thinking * generated_rate
) / 1_000_000 + tools_usd
task_cost_usd = sum(cost of each non-overlapping row)
Из-за этого вычитания кэшированный вход должен быть подмножеством общего. Если сначала оценить весь вход по обычной ставке, а затем добавить кэш, эти токены окажутся оплачены в расчёте дважды. Не добавляйте сюда стоимость хранения явного кэша: указанная ставка Carbon относится к входу, попавшему в неявный кэш, а явное кэширование не поддерживается.
Запустите полный калькулятор локально
Скачайте набор для расчёта стоимости задач Carbon, распакуйте его и перейдите в carbon-task-cost-kit. Внутри находятся cost.py, CLI calculate.py, два тестовых модуля, два примера реестра и README на английском. Используется только стандартная библиотека Python: SDK модели, ключ и сетевой вызов не нужны.
Нужен Python 3.11 или новее. Перед заменой примеров запустите тесты:
python -m unittest test_cost.py test_cli.py -v
Ожидаемый результат — 24 успешных теста: 16 проверок калькулятора и восемь проверок CLI. Они охватывают десятичную арифметику, допустимость кэшированного подмножества, пропущенный usage, повторяющиеся ID, неверные периоды, повторяющиеся ключи JSON, некорректные реестры и точный вывод CLI. Это проверка локального инструмента, а не реализации биллинга поставщика.
Файл single-attempt.json содержит одну условную попытку:
[
{
"id": "illustrative-success",
"input_total": 50000,
"cached_input": 40000,
"generated_including_thinking": 6000,
"tools_usd": "0"
}
]
Запустите встроенные сценарии:
python calculate.py single-attempt.json --period through-2026-11-30
python calculate.py single-attempt.json --period from-2026-12-01
python calculate.py retry-task.json --period through-2026-11-30
Итоги в USD будут соответственно "0.084", "0.168" и "0.234". JSON-вывод также разбивает каждую строку на обычный вход, кэшированный вход, генерацию и инструменты. Деньги выводятся десятичными строками для точного счёта, без округления каждого промежуточного слагаемого до центов. Форматировать сумму для отображения следует после сохранения точного результата.
Для своего реестра скопируйте пример в новый JSON, вставьте значения с подтверждённым смыслом и выполните python calculate.py your-ledger.json --period through-2026-11-30 либо укажите второй явный период. До обработки большого числа строк сопоставьте компоненты с ручным расчётом. Пустой реестр отклоняется: он не доказывает, что завершённая задача ничего не стоила.
Программа завершится с ошибкой при отсутствующих количествах, отрицательных или нецелых токенах, кэше больше общего входа, повторных ID, дублирующихся ключах JSON и неожиданных полях. Плата за инструменты должна быть известным неотрицательным десятичным значением; в JSON используйте строку, например "0.01". Дополнительное слагаемое рассуждений или переопределение цены в строке также отклоняются, чтобы нормализация оставалась явной. Комментарии человека и ссылки на исходные записи держите отдельно, а не добавляйте произвольно в расчётную схему.
Пересчитайте примеры задач
Ниже используется вымышленный нормализованный usage. Эти числа не предсказывают потребление Carbon для вашего промпта, попадание в кэш или соответствие результата вашим требованиям к качеству.
Одна принятая попытка по текущим ставкам
Пусть общий вход составляет 50 000 токенов, включая 40 000 попаданий в кэш, генерация с рассуждениями — 6 000 токенов, а отдельная плата за инструменты заведомо равна нулю. Обычный вход тогда равен 10 000 токенов.
- Обычный вход:
10,000 × $2 / 1,000,000 = $0.020. - Кэшированный вход:
40,000 × $0.10 / 1,000,000 = $0.004. - Генерация с рассуждениями:
6,000 × $10 / 1,000,000 = $0.060. - Итого: $0,084.
Видимый итоговый текст может содержать меньше 6 000 токенов: в примере генерация уже дана вместе с рассуждениями, поэтому ещё раз прибавлять их нельзя.
Тот же usage по объявленным декабрьским ставкам
При неизменных количествах получается $0.040 + $0.008 + $0.120 = $0.168. Это ровно вдвое больше сценария только с токенами, поскольку все три ставки Standard удваиваются. Мы сравниваем периоды при одинаковом потреблении, а не предсказываем, что реальные декабрьские задачи используют столько же токенов.
Если в обоих периодах есть известная отдельная плата за инструмент $0,01, итоги будут $0,094 и $0,178. Удвоение первого итога до $0,188 ошибочно удвоило бы неизменившуюся плату за инструмент. Сумма $0,01 здесь условная, а не опубликованная цена инструмента Google.
Неудачная первая попытка и принятая вторая
В retry-task.json перед принятой попыткой из примера добавлена первая попытка с известным usage: 50 000 входных токенов без кэша и 5 000 сгенерированных токенов вместе с рассуждениями. В обеих строках отдельная плата за инструменты условно равна нулю.
[
{
"id": "illustrative-failed-attempt",
"input_total": 50000,
"cached_input": 0,
"generated_including_thinking": 5000,
"tools_usd": "0"
},
{
"id": "illustrative-success",
"input_total": 50000,
"cached_input": 40000,
"generated_including_thinking": 6000,
"tools_usd": "0"
}
]
Первая строка стоит $0.100 + $0.050 = $0.150. Вместе с успешной строкой это $0,234 за задачу, хотя принятая попытка сама по себе стоит $0,084. «Неудачная» здесь означает условную попытку с независимо известным оплачиваемым объёмом. Это не утверждение, что каждый отклонённый HTTP-запрос оплачивается таким образом.
Меняя по одному условию, можно увидеть чувствительность расчёта:
| Условный сценарий | Итого USD | Что изменилось |
|---|---|---|
| Текущие ставки, 40 000 токенов из кэша, 6 000 генерации | $0,084 | Базовый пример |
| Текущие ставки, без кэша, те же общие вход и генерация | $0,160 | Все 50 000 входных токенов по обычной цене |
| Текущие ставки, 40 000 из кэша, 16 000 генерации | $0,184 | Ещё 10 000 токенов генерации вместе с рассуждениями |
| Декабрьские ставки, базовые количества | $0,168 | Только период тарифа |
| Текущие ставки, база плюс известные $0,01 за инструмент | $0,094 | Только отдельная плата |
| Декабрьские ставки, база плюс те же $0,01 | $0,178 | Токены подорожали, инструмент — нет |
Это арифметические примеры, а не бенчмарк модели и не обещание, что конкретное изменение промпта сэкономит указанную разницу.
Разберитесь с условиями кэша и короткими ходами агента
В руководстве Google по кэшированию (на английском) для неявного кэша Carbon указан минимум 4 096 входных токенов. Выполнение условия не гарантирует попадания. Приведённая кэшированная ставка на 95% ниже обычной входной, но только для фактически попавших в кэш токенов. Это не скидка 95% на все токены или всю задачу.
Carbon не поддерживает создание явного кэша и ссылки cached_content. Не добавляйте ID явного кэша ради попытки применить льготную колонку. Стабильные общие префиксы и похожие запросы в близкое время могут увеличить вероятность неявного повторного использования, но реестр должен опираться на фактический отчёт о попаданиях. Документация указывает usage.total_cached_tokens для их учёта; перед нормализацией всё равно проверьте связь с общим входом эндпоинта.
Там же описано отдельное правило Gemini 4 для многоходовых диалогов и циклов агента: предыдущий запрос кэшируется целиком только тогда, когда новый добавляет не менее 2 050 токенов, включая выход модели, рассуждения и результаты функций. Если добавка меньше, последние 2 050 токенов предыдущего запроса обрабатываются повторно по обычной входной ставке.
Это правило не совпадает с порогом допуска к кэшированию в 4 096 токенов. Оно не означает потерю кэша всего диалога и не задаёт фиксированную доплату на каждом ходе. Если нормализованные вход и кэш уже отражают фактическую обработку, дополнительное прибавление 2 050 даст двойной учёт. Используйте правило, чтобы объяснять неожиданный usage, а не создавать вымышленный объём сверх измеренных полей.
Например, два агента с одинаковыми длинными начальными инструкциями могут иметь разные входные расходы из-за разного количества нового материала на каждом ходе. Сравнивайте реальные записи входа и кэша. Не дополняйте промпты искусственно только ради порога, не оценив дополнительную обработку и качество принятого результата.
Заложите в бюджет рассуждения, историю и продолжения
В документации Carbon (на английском) сказано, что max_output_tokens ограничивает сумму рассуждений и выхода. Это не долларовый бюджет всей агентной задачи. Вход, инструменты, повторы и следующие вызовы могут увеличивать расходы за пределами лимита генерации одного ответа.
Carbon поддерживает уровни рассуждений low, medium и high; документированный уровень по умолчанию — medium. Уменьшение уровня может изменить и потребление, и вероятность полезного результата. Более дешёвая попытка не обязательно означает более дешёвую принятую задачу, если потребуется больше повторов. Выбирайте настройку после проверки на одинаковой задаче с одинаковыми правилами приёмки. В статье нет эксперимента, сравнивающего качество этих уровней.
Длинная генерация может проходить через несколько шагов продолжения. Серверное продолжение в фоне может возвращать накопленное взаимодействие, а клиентский цикл — отдельные записи. Общий контекст Carbon включает вход, рассуждения и выход: большой размер окна не означает независимый лимит для каждого из трёх компонентов. Руководство по настройке Carbon объясняет конфигурацию и варианты продолжения; реестр расходов должен соответствовать реальным границам выдаваемого usage.
Для многоходового агента отслеживайте, какие части истории и результаты инструментов входят в каждый запрос. Даже если пользователь добавил одно короткое предложение, оплачиваемый вход может включать сохранённый контекст. И наоборот, правильно выделенную кэшированную часть не следует снова считать обычным входом. Никогда не суммируйте итог накопленного взаимодействия с его составляющими шагами.
Практический контроль расходов состоит из лимита генерации на ответ, максимума шагов агента, правил для неопределённых исходов и бюджета задачи, проверяемого между шагами. Калькулятор оценивает известный usage или прогноз с явно заданными допущениями. Он не гарантирует остановку уже выполняющегося запроса на точной долларовой границе и не восстанавливает неотражённые списания.
Рассматривайте повторы и отсутствующий usage как вопросы учёта
Тайм-аут клиента не устанавливает, выполнил ли сервер запрос. HTTP-ошибка не доказывает оплату каждой такой попытки, а отсутствующий usage — нулевое потребление. Сохраните идентификатор запроса и отметьте строку как неизвестную до уточнения по записям поставщика. Не вставляйте вымышленные нули лишь ради того, чтобы калькулятор принял реестр.
До повтора различайте ошибки аутентификации, доступа, квоты, параметров и временные сбои. Разбор ошибок Gemini 4 API даёт полезную классификацию, но примеры конкретной модели относятся к Argon, а не Carbon. Для приложений на API Ofox используйте соответствующую документацию по обработке ошибок и повторам. Само наличие этой ссылки не подтверждает поддержку данного маршрута Carbon в Ofox.
Учитывайте каждую действительно отдельную попытку один раз. Повтор может быть новым запросом, а GET для получения результата — только чтением уже выполненной работы. Не называйте оба действия второй генерацией без проверки контракта. Аналогично две записи об одной попытке — в приложении и у провайдера — не превращаются в две строки расходов только из-за разных источников.
Определяйте успех на уровне задачи. Для программирования запись приёмки может включать требуемое изменение, результат нужного теста и принятие итогового артефакта. Для извлечения данных — корректность схемы и проверенное соответствие источникам. HTTP 200 сам по себе не доказывает ни одно из этих условий. Храните свидетельства приёмки рядом с реестром, защищая приватные исходные материалы.
Сравнивая варианты, берите один набор задач и правила приёмки, включайте известные неуспешные попытки и отдельно сообщайте о неразрешённом usage. Тогда стоимость принятой задачи можно получить делением относимых расходов на число принятых задач. Если не принято ни одной, сообщите об этом, а не придумывайте конечную стоимость успеха. Метки приёмки в примерах условные; доля успешных задач здесь не измерялась.
Сверьте реестр с записями поставщика
Начните с небольшой задачи, для которой можете объяснить границы usage. Приватно сохраните сырой ответ, пояснения нормализации, точную модель и уровень, снимок тарифа, расчётный период, ID попыток, версию калькулятора и результат приёмки. Выполните расчёт и сравните составляющие с записями провайдера. Прежде чем умножать оценку на тысячи задач, разберитесь с расхождениями.
Если задача пересекает дату изменения цены, разделите строки по применимым периодам, рассчитайте группы отдельно и сложите точные суммы. CLI намеренно применяет один явно выбранный период ко всему входному файлу. Он не выводит даты или часовые пояса автоматически и отклоняет переопределения в отдельных строках. Для реальных данных используйте фактические правила поставщика о моменте вступления цены в силу. Расчёт по будущим ценам остаётся прогнозом даже при точной арифметике.
Результат по usage также отличается от налога, конвертации валют, договорных корректировок и округлений на уровне счёта. Сохраняйте десятичную точность в ходе расчёта, а последующее округление для отображения описывайте отдельно. Не пересчитывайте исторический счёт по сегодняшнему прайсу.
Для моделей, поддерживаемых Ofox, документация по учёту использования объясняет разбивку запросов, токенов и расходов, а документация по оплате указывает на представления стоимости и каталог. При проверке 15 ноября мы проследили прокси catalog в ofoxai/home-page на коммите 0e0c8cc6e655b606466142aae0929a666fbaaf0e и сохранили все 133 записи текущего публичного ответа. Carbon в этом снимке отсутствовал. Это не доказательство постоянной недоступности, но подтверждённой цены Ofox Carbon для цитирования у статьи нет. Приведённые ставки Google нельзя выдавать за ставки Ofox.
Журналы содержимого запросов Ofox — отдельная функция, не тождественная записям usage и списаний. Сохранение содержимого по умолчанию выключено; после включения уполномоченным администратором команды оно действует на последующие запросы в настроенной области. Не рассчитывайте восстановить старые промпты и не считайте, что для подсчёта стоимости обязательно хранить весь текст. Собирайте доказательства в соответствии с правилами обращения с данными вашей команды.
Итоговый результат — реестр, который можно связать с известным usage, выбранным тарифным периодом и принятой задачей. Если показатель остаётся неизвестным, сохраните это ограничение. Воспроизводимый расчёт с понятными границами полезнее точной на вид суммы на непроверенных предположениях.


