
Gemini 4 Carbon API и Gemini 4 Argon API принимают одинаковый запрос и стоят одинаково за входной и выходной токен, поэтому выбор между ними — это решение о маршрутизации, а не миграция. В PoYo переключение сводится к изменению одной строки: gemini-4-carbon (страница модели) или gemini-4-argon (страница модели). В этой статье: чем модели различаются на уровне API, что разница в бенчмарках Google говорит о том, какие запросы стоит отправлять в Carbon, и маршрутизатор, который можно сразу вставить в код.
Впервые работаете с Carbon? Начните с обзора Gemini 4 Carbon API и руководства по первому запросу. Отдельно об Argon — в руководстве по Gemini 4 Argon API.
Gemini 4 Carbon API vs Gemini 4 Argon API: основное
| Gemini 4 Carbon | Gemini 4 Argon | |
|---|---|---|
| ID модели в PoYo | gemini-4-carbon | gemini-4-argon |
| Эндпоинты в PoYo | POST /v1/chat/completions, POST /v1beta/models/gemini-4-carbon:generateContent / :streamGenerateContent | Те же два формата, с gemini-4-argon |
| Контекстное окно | 1M токенов | 1M токенов |
| Максимальный вывод на ответ | 64K токенов | Больше: Google описывает единый лимит на вход и выход в 1M (см. наше руководство по Argon) |
| Типы входных данных | Текст, изображения, аудио, видео, PDF | Текст, изображения, аудио, видео, PDF |
| Позиционирование Google | Самая сильная модель для рассуждений; тратит больше токенов на исследование, рассуждение и проверку | Эффективная модель: более быстрые ответы, меньше токенов на ход |
| Рекомендация Google | Самая сложная многошаговая разработка, отладка, открытые исследования | «Идеальный выбор для большинства задач разработки ПО и работы со знаниями» |
Структура запроса идентична. В Chat Completions ID модели передаётся в поле model, в Gemini Native — в пути URL. Обе модели поддерживают стриминг ("stream": true или :streamGenerateContent). Ошибки тоже одинаковые: 400 при некорректных полях или неверном формате, 401 при неверном ключе, 404 при неизвестном ID модели и 402, когда заканчиваются кредиты.
Единственный лимит, который однозначно определяет маршрут, — размер вывода. Задокументированный потолок Carbon — 64K выходных токенов на ответ. Если один ответ должен быть длиннее (например, полная переработка нескольких файлов за один проход), отправляйте его в Argon.
Diff миграции: что меняется в JSON
Перевод запроса с Argon на Carbon в Chat Completions:
{
- "model": "gemini-4-argon",
+ "model": "gemini-4-carbon",
"messages": [
{"role": "user", "content": "Find the root cause of the failing test and propose a patch."}
],
- "max_tokens": 120000,
+ "max_tokens": 64000,
"stream": true
}
В Gemini Native меняется только путь:
POST https://api.poyo.ai/v1beta/models/gemini-4-argon:generateContent
POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent
При вызове Carbon ограничьте max_tokens (Chat Completions) или generationConfig.maxOutputTokens (Gemini Native) значением 64,000 или меньше. Больше в теле запроса ничего менять не нужно.
Цена за токен: одинаковая, кроме чтения из кэша
Цены PoYo с текущих страниц моделей (1 кредит = $0.005):
| Счётчик (за 1M токенов) | Gemini 4 Carbon в PoYo | Gemini 4 Argon в PoYo | Официально у Google (обе, вводная цена) |
|---|---|---|---|
| Вход | $1.60 (320 кредитов) | $1.60 (320 кредитов) | $2.00 |
| Выход (включая мышление) | $8.00 (1,600 кредитов) | $8.00 (1,600 кредитов) | $10.00 |
| Чтение из кэша | $0.08 (16 кредитов) | $0.16 (32 кредита) | $0.10 (скидка 95% от входа) |
Google запустила Carbon по вводной цене Argon. В посте о доступности сказано, что вводный период заканчивается 30 ноября 2026 года, а с 1 декабря действуют $4 за вход и $20 за выход за 1M токенов. В статье о ценах Carbon обе ставки Google сравниваются с текущей ценой PoYo.
Разница — в строке чтения из кэша: в PoYo чтение из кэша у Carbon стоит вдвое дешевле, чем у Argon. Экономия реальная, но небольшая. Это $0.08 за 1M кэшированных токенов, и 10,000 дополнительных выходных токенов ($0.08 при $8.00 за 1M) её полностью съедают. Поскольку, по словам Google, Carbon тратит на задачу больше токенов, чем Argon, на большинстве нагрузок ожидайте, что задача на Carbon обойдётся дороже, даже с более дешёвым кэшем.
Пример расчёта с одинаковым числом токенов (400K прочитано из кэша, 50K нового входа, 20K выхода):
| Carbon | Argon | |
|---|---|---|
| Расчёт | 0.4 × $0.08 + 0.05 × $1.60 + 0.02 × $8.00 | 0.4 × $0.16 + 0.05 × $1.60 + 0.02 × $8.00 |
| Стоимость | $0.272 (54.4 кредита) | $0.304 (60.8 кредита) |
Если на ту же задачу Carbon нужно 30K выходных токенов вместо 20K, она стоит $0.352. Именно поэтому измерять нужно стоимость выполненной задачи, а не стоимость токена. Скрипт для измерения приведён ниже.
Разница в бенчмарках как аргумент для маршрутизации
Это собственные цифры Google из таблицы к запуску Gemini 4 Carbon, поэтому воспринимайте их как сравнение от вендора, а не как независимый тест. Колонка с разницей показывает, где дополнительные токены окупаются.
| Бенчмарк | Carbon | Argon | Разница |
|---|---|---|---|
| ExploitGym | 54.8% | 42.0% | +12.8 |
| GraphWalks 256K–1M (BFS F1) | 96.2% | 84.2% | +12.0 |
| AA Intelligence Index v5.0 | 59 | 50 | +9 |
| Agents' Last Exam v1.1 | 77.4% | 69.0% | +8.4 |
| Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | +8.1 |
| OSWorld-2.1 (офлайн-подмножество) | 81.5% | 74.7% | +6.8 |
| FrontierSWE 2 | 61.2% | 55.0% | +6.2 |
| SWE-sweep | 9.6% | 4.3% | +5.3 |
| SEC-bench Pro | 88.2% | 83.4% | +4.8 |
| RiemannBench | 80.0% | 76.0% | +4.0 |
| CWE-bench | 71.0% | 68.0% | +3.0 |
| AutomationBench (Zapier) | 53.9% | 51.3% | +2.6 |
| Vals Index v2.2 | 70.4% | 69.2% | +1.2 |
Читайте её как таблицу маршрутизации:
- Большой разрыв: направляйте в Carbon. Поиск по длинному контексту в 256K–1M токенов, агентная работа в терминале, многошаговые агентные задачи и проверка эксплойтов.
- Небольшой разрыв: оставляйте на Argon. Автоматизация бизнес-процессов (+2.6), общая работа со знаниями (Vals Index, +1.2) и генерация патчей на CWE-bench (+3.0). Здесь Argon набирает большую часть результата, тратя меньше токенов на ход.
- Оговорка о кибербезопасности. Результаты Google в кибербезопасности получены при доступе через программу Fairwind, а в посте о доступности сказано, что Carbon для киберзадач предлагается только через эту программу. Не рассчитывайте, что публичный API воспроизведёт эти результаты. Проверяйте на своих задачах.
Сравнивайте результаты только в пределах одной таблицы. Наше руководство по Argon цитирует таблицу Google к запуску Argon, где для Argon указано 57.4% на Terminal-Bench 4.0. В таблице Carbon используется harness от Artificial Analysis (57.1%).
Стратегия маршрутизации: по умолчанию Argon, эскалация в Carbon
Рекомендации Google и разрывы в бенчмарках указывают на одну и ту же схему:
- По умолчанию отправляйте каждый запрос в
gemini-4-argon. - Заведомо сложные типы задач направляйте сразу в
gemini-4-carbon: отладку на уровне всего репозитория, терминальных агентов, вопросы по контексту больше 256K токенов и триаж в области безопасности. - Эскалируйте при неудаче. Если ответ Argon не прошёл вашу проверку (тесты, валидация схемы, грейдер) или остановился с
finish_reason: "length", повторите один раз на Carbon. - Принудительно выбирайте Argon, если ответ должен быть длиннее 64K токенов.
Этот маршрутизатор использует OpenAI SDK, направленный на эндпоинт Chat Completions в PoYo. Он отправляет только задокументированные поля: model, messages и max_tokens.
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["POYO_API_KEY"], base_url="https://api.poyo.ai/v1")
ARGON, CARBON = "gemini-4-argon", "gemini-4-carbon"
CARBON_MAX_OUTPUT = 64_000
# PoYo USD per 1M tokens, from the model pages on 2026-11-16
PRICE = {ARGON: (1.60, 8.00), CARBON: (1.60, 8.00)}
# Task types where Google's table shows the widest Carbon lead
CARBON_TASKS = {"repo_debug", "terminal_agent", "long_context_qa", "security_triage"}
def pick_model(task_type: str, max_tokens: int) -> str:
if max_tokens > CARBON_MAX_OUTPUT:
return ARGON
return CARBON if task_type in CARBON_TASKS else ARGON
def call(model: str, messages: list, max_tokens: int) -> dict:
resp = client.chat.completions.create(model=model, messages=messages, max_tokens=max_tokens)
u = resp.usage
price_in, price_out = PRICE[model]
cost = u.prompt_tokens / 1e6 * price_in + u.completion_tokens / 1e6 * price_out
return {
"model": resp.model,
"text": resp.choices[0].message.content,
"finish_reason": resp.choices[0].finish_reason,
"prompt_tokens": u.prompt_tokens,
"completion_tokens": u.completion_tokens,
"cost_usd": round(cost, 6),
}
def run(task_type: str, messages: list, check, max_tokens: int = 16_000) -> list:
"""Returns every attempt so you can log cost per task, including escalations."""
first = pick_model(task_type, max_tokens)
attempts = [call(first, messages, max_tokens)]
a = attempts[-1]
failed = a["finish_reason"] == "length" or not check(a["text"])
if first == ARGON and failed and max_tokens <= CARBON_MAX_OUTPUT:
attempts.append(call(CARBON, messages, max_tokens))
return attempts
check — ваш собственный приёмочный тест, например «патч применяется и тесты проходят» или «JSON проходит валидацию по моей схеме». Оценка стоимости считает каждый токен промпта некэшированным входом. Задокументированные поля usage в PoYo не выделяют кэшированные токены, так что это оценка сверху.
Измеряйте стоимость задачи сами
Цены за токен одинаковые, поэтому единственное число, которое различает эти два API, — стоимость принятой задачи. Логируйте каждую попытку из run():
| Поле для логирования | Источник в Chat Completions | Источник в Gemini Native |
|---|---|---|
| Фактически использованная модель | model | Путь URL |
| Входные токены | usage.prompt_tokens | usageMetadata.promptTokenCount |
| Выходные токены | usage.completion_tokens | usageMetadata.candidatesTokenCount + thoughtsTokenCount |
| Упёрся в лимит вывода | finish_reason == "length" | finishReason |
| Прошёл вашу проверку | ваш грейдер | ваш грейдер |
Google тарифицирует вывод вместе с токенами мышления, поэтому в Gemini Native считайте thoughtsTokenCount выходом. При стриминге usage приходит в последнем чанке Chat Completions. Затем для каждого типа задач:
cost per accepted task = sum(cost_usd of all attempts, incl. escalations) / tasks that passed
Пропустите неделю реального трафика с Argon по умолчанию и сравните с выборкой, отправленной сразу в Carbon. Если Carbon решает задачи, для которых Argon требовалась эскалация, добавьте этот тип задач в CARBON_TASKS. Если доля успешных решений Carbon для какого-то типа совпадает с Argon, оставьте этот тип на Argon. На первых нескольких сотнях вызовов сверяйте панель PoYo со своим логом.
Если вы также рассматриваете модели других вендоров, см. Gemini 4 Carbon API vs Claude Opus 5.5 API vs GPT-6 Astra API. Агентный цикл с ограничением бюджета описан в статье Gemini 4 Carbon API для агентов разработки.
Часто задаваемые вопросы
Дороже ли Gemini 4 Carbon API, чем Gemini 4 Argon API?
Не за токен. Обе стоят $1.60 за вход и $8.00 за выход за 1M токенов в PoYo и $2.00 / $10.00 по вводным ценам Google. В PoYo чтение из кэша у Carbon дешевле ($0.08 против $0.16 за 1M). В расчёте на задачу Carbon обычно дороже, потому что, по словам Google, тратит больше токенов на рассуждение и проверку.
Как перейти с Gemini 4 Argon API на Gemini 4 Carbon API?
Замените "model": "gemini-4-argon" на "model": "gemini-4-carbon" в Chat Completions или смените модель в пути URL Gemini Native. Для Carbon держите max_tokens не выше 64,000.
Какой максимальный вывод у Gemini 4 Carbon API по сравнению с Argon?
Carbon возвращает до 64K выходных токенов на ответ при контекстном окне 1M токенов. Argon допускает гораздо более длинные одиночные ответы, поэтому выводы длиннее 64K направляйте в Argon.
Что использовать для разработки: Gemini 4 Argon или Gemini 4 Carbon?
По словам Google, Argon остаётся идеальным выбором для большинства задач разработки ПО. Используйте Carbon для самой сложной многошаговой отладки и агентной работы в терминале, где таблица Google показывает наибольшие разрывы: Terminal-Bench 4.0 (AA) 65.2% против 57.1% и SWE-sweep 9.6% против 4.3%.
Используют ли Gemini 4 Carbon и Argon один и тот же эндпоинт API?
Да. Обе работают с POST https://api.poyo.ai/v1/chat/completions (OpenAI-совместимый) и POST https://api.poyo.ai/v1beta/models/{model}:generateContent или :streamGenerateContent (Gemini Native) с одним и тем же API-ключом PoYo.