Примечание автора: у одного и того же Gemini 4 Neon контекстное окно в объявлении Gemini API и в документации модели Antigravity указано по-разному. В этой статье мы разводим два числа по точкам входа и даём порядок проверки, который стоит пройти перед тем, как записывать размер окна в план агента.
Команды, которые делают агентов, часто переносят размер контекстного окна прямо с маркетинговой страницы в план, например: «Neon поддерживает 1M, весь репозиторий кода можно засунуть туда за один раз». В поколении Gemini 4 Neon такой подход легко приводит к проблемам. В объявлении Gemini API указано 1,048,576 токенов, а в документации модели Antigravity — до 512K токенов. Оба числа принадлежат Google, появились в одну и ту же неделю, и ни одна из страниц не ссылается на другую.
Дело не в том, что кто-то ошибся. Они описывают два разных интерфейса вызова: один — прямой вызов API модели, другой — агентская точка входа в Antigravity. Какое число указывать в плане, зависит от того, через какую точку входа фактически уходит ваш запрос.
Что вы получите: после прочтения вы будете знать, откуда взялось каждое из двух чисел окна Gemini 4 Neon, и освоите порядок проверки «сначала определить точку входа, затем проверить уровень рассуждений и только потом записывать размер окна». Если действовать в таком порядке, вы не станете планировать 1M для точки входа, где доступно только 512K.

Gemini 4 Neon: главное о контекстном окне
Сначала соберём в одну таблицу факты, которые можно подтвердить по документации. Все числа в таблице — это дословные данные из соответствующих документов, а не расчёты и не результаты тестов.
| Пункт | Что говорит документация | Что это значит для проекта |
|---|---|---|
| Окно Gemini API | Анонс Google от 2026-11-18: единое контекстное окно Neon — 1,048,576 token |
Верхняя граница при планировании, если вызывать API напрямую |
| Окно в Antigravity | Документация моделей Antigravity: контекст Gemini 4 Neon — до 512K token |
Верхняя граница при планировании, если запускать агента внутри Antigravity |
| Уровень размышлений | В документации Antigravity перечислены Low, Medium, High (по умолчанию), Extra | По умолчанию стоит High — сначала уточните это, а потом считайте |
| Как связаны два документа | Опубликованы на одной неделе, страницы друг на друга не ссылаются | Нельзя выводить числа одной страницы из другой |
| Цены API | Вход $3, кэшированный вход $0.15, выход $15 (за миллион token) |
Оценку стоимости считайте по API-эндпоинту |
Почему обе цифры для Gemini 4 Neon верны
И 1M, и 512K — официальные данные Google, просто они написаны на разных страницах. В анонсе Gemini API речь идёт о едином контексте модели на уровне API, в тексте прямо указано 1,048,576 token. В документации моделей Antigravity речь идёт о контексте Neon внутри продукта Antigravity, и там дословно написано «до 512K token». Это две разные поверхности, каждая цифра верна в своём контексте — так что противоречия здесь нет.
OrcaRouter в статье от 2026-11-19 отдельно обращает внимание на это расхождение. Там же упоминается, что пользователь соцсети @kimmonismus 18 ноября публиковал запись с логом вызова инструментов. Это сторонний пост, а не разъяснение Google о размере окна, и ссылаться на него как на спецификацию окна нельзя. Когда пишете план, берите числа окна только со страниц документации Google — и указывайте, с какой именно страницы.
Не смешивайте окно Gemini 4 Neon с окнами других моделей серии
Ещё одна частая ошибка — переносить числа с одной модели на другую. На странице модели Gemini 4 Carbon контекст тоже указан как 1,048,576, но это окно Carbon на уровне API, и подставлять его к Neon в Antigravity нельзя. Точно так же окно Neon на уровне API нельзя автоматически переносить на Neon в Antigravity. Число должно совпадать сразу по двум измерениям — модель и точка входа; если хотя бы одного нет, проверка не завершена.

Сравнение двух входов Gemini 4 Neon
Таблица ниже разбирает два входа по отдельности. Колонка «Рекомендации по планированию» — это практические советы при составлении плана, а не спецификация из документации.
| Параметр | Gemini API (включая агрегированный интерфейс, совместимый с OpenAI) | Antigravity |
|---|---|---|
| Исходный размер окна | 1,048,576 token (по объявлению Google) |
до 512K token (документация модели) |
| Источник | Gemini API / объявление Google от 2026-11-18 | antigravity.google/docs/models |
| Уровень рассуждений | по параметрам в документации API | Low, Medium, High (по умолчанию), Extra |
| Способ тарификации | оплата по token, есть цена за кэшированный ввод | по правилам продукта Antigravity |
| Рекомендации по планированию | для одного запроса можно рассчитывать на длинный контекст, но всё равно нужно оставлять запас | планировать исходя из 512K, длинные задачи разбивать на части и сжимать |
Анализ входа API: при прямом вызове API окно больше, он подходит для того, чтобы за один раз загрузить большую партию документов, длинные логи или целые куски кода для анализа. Однако большое окно не означает, что каждый раз нужно заполнять его целиком: чем длиннее ввод, тем выше стоимость и задержка. Для сравнения, если рассматривать API как вход, где «длинный материал прочитывается за один раз», да ещё с ценой за кэшированный ввод, он лучше подходит для офлайн-пакетной обработки и анализа больших фрагментов после поиска.
Анализ входа Antigravity: Antigravity ориентирован на рабочие процессы агентов, документация даёт окно до 512K. Агент накапливает историю в ходе многократных вызовов инструментов, и фактически доступное пространство расходуется быстрее, чем при одиночном запросе. Командам, которые запускают длинные задачи в Antigravity, надёжнее планировать разбиение на части, суммаризацию и стратегию вытеснения контекста исходя из 512K, а не оценивать по 1M.

Уровни рассуждений Gemini 4 Neon в Antigravity
Документация Antigravity перечисляет четыре уровня рассуждений, по умолчанию — High. Многие не замечают значение по умолчанию и сразу берут верхний предел окна для расчёта бюджета. В таблице ниже — рекомендации по планированию по уровням; названия уровней и значения по умолчанию взяты из документации, а рекомендации — это общая практика.
| Уровень рассуждений | Отметка в документации | Рекомендации по планированию |
|---|---|---|
| Low | опционально | подходит для коротких цепочек и детерминированных вызовов инструментов |
| Medium | опционально | подходит для обычного программирования и многошагового поиска |
| High | по умолчанию | если не менять настройки, будет этот уровень, по нему и оценивайте бюджет |
| Extra | опционально | подходит для сложных задач, оставляйте больше запаса и времени на ожидание |
Уровень рассуждений влияет на затраты на рассуждения и время ответа; как именно это учитывается в контексте и тарификации — смотрите документацию Antigravity. При проверке сначала уточните, какой уровень команда реально использует, особенно High по умолчанию, и уже потом решайте, сколько места в каждом раунде оставить под историю и материалы поиска.
Быстрый старт с Gemini 4 Neon
Шаг 1: определите, через какой интерфейс вы вызываете модель
Сначала ответьте на вопрос: откуда именно отправляется запрос? Если вы отправляете запросы из кода через SDK, вы работаете через API-интерфейс, и контекстное окно планируйте исходя из 1,048,576. Если же вы даёте агенту задачу в Antigravity, вы работаете через интерфейс Antigravity, и окно здесь — максимум 512K. Если в одном проекте используются оба варианта, в документе с планом нужно сделать два отдельных раздела, а не сводить всё к одному числу.
Шаг 2: Отправляем один запрос через OpenAI-совместимый интерфейс
Если работать через API-интерфейс, можно вызывать Neon через OpenAI-совместимый интерфейс APIYI — ID модели gemini-4-neon. Для минимального вызова достаточно всего трёх настроек:
- Создать клиент:
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - Указать модель:
model="gemini-4-neon" - Отправить сообщение:
client.chat.completions.create(model="gemini-4-neon", messages=[{"role": "user", "content": "总结这份日志"}])
После возврата запроса прочитайте response.usage.prompt_tokens и response.usage.completion_tokens — так вы получите фактический расход за этот вызов. При планировании окна ориентируйтесь именно на это возвращаемое значение, а не на оценку по количеству символов.
Посмотреть полную схему вызовов с разбиением на части
Когда длинный материал превышает заданный вами бюджет на один вызов, можно разбить его на части по такой схеме:
1. Инициализация: `client = OpenAI(api_key=»YOUR_API_KEY», base_url=»https://api.apiyi.com/v1″)`
2. Задать бюджет: на стороне API можно установить `budget = 1048576 * 0.7`; если ту же логику нужно переиспользовать на стороне Antigravity, задайте семь десятых от 512K
3. Разбить материал: разделите документ на `chunks` по главам или файлам, для каждого фрагмента сначала сделайте пробный прогон с `usage.prompt_tokens` и запишите реальную длину
4. Суммировать по частям: для каждого chunk вызовите `model=»gemini-4-neon»`, требуя вывода резюме в фиксированном формате
5. Объединить и вывести рассуждение: соберите все резюме в новые `messages` и сделайте финальное обобщение или решение
6. Записывать расход: на каждом раунде вносите `prompt_tokens` и `completion_tokens` в лог, чтобы потом сверять затраты
Семь десятых в бюджете — это лишь эмпирический приём для запаса, а не требование документации; значение можно корректировать под задачу.
🚀 Быстрый старт: перед составлением плана можно зарегистрироваться на APIYI apiyi.com и получить бесплатную тестовую квоту, прогнать реальный материал на
gemini-4-neonи только после получения возвращаемого значенияusageопределять бюджет окна.
Шаг 3: Проверка модели и цены
Проверить цену можно двумя способами: через сводную таблицу моделей APIYI по адресу https://docs.apiyi.com/models.md и через эндпоинт цен https://api.apiyi.com/api/pricing. На момент проверки 2026-11-20 сводная таблица последний раз обновлялась 2026-11-19 10:59 (UTC+8), и в той версии gemini-4-neon ещё не было; зато в эндпоинте цен (версия shell-api-modelmak-v1) эта модель уже присутствует. Поэтому при проверке цены Neon ориентируйтесь на эндпоинт цен.
В эндпоинте цен model_ratio, равный 1, соответствует входу $2 за миллион токенов. У gemini-4-neon model_ratio равен 1.5, completion_ratio — 5, cache_ratio — 0.05. После пересчёта получаем вход $3, выход $15, чтение кэша $0.15 — совпадает с ценой, указанной Google.
| Модель | Вход ($/миллион токенов) | Чтение кэша | Выход | Примечание |
|---|---|---|---|---|
gemini-4-neon |
3 |
0.15 |
15 |
Совпадает с ценой Google, ориентироваться на эндпоинт цен |
gemini-4-carbon |
2 |
0.1 |
10 |
Соответствует вводной цене Google до 2026-11-30 |
gemini-4-hydrogen |
1.5 |
0.075 |
7.5 |
Эндпоинт цен |
gemini-4-argon |
2 |
0.1 |
10 |
Сводная таблица моделей |
| Доступные платформы | APIYI, официальный API Google | — | — | Адрес вызова https://api.apiyi.com/v1 |
У Carbon есть один нюанс, который стоит учитывать: стандартная цена Google с 1 декабря — вход $4, выход $20, а вводная цена действует только до 2026-11-30. Бюджет на стыке месяцев придётся считать в два этапа.
💡 Совет по выбору: одну и ту же задачу можно сначала прогнать через
gemini-4-neonиgemini-4-hydrogenпо очереди, а потом сравнить результат иusage. APIYI предоставляет единый OpenAI-совместимый интерфейс — чтобы сменить модель, достаточно изменить параметрmodel.
Как заложить бюджет контекста Gemini 4 Neon в план
Когда точка входа и уровень мышления уже определены, можно переносить цифры контекстного окна в план. Ниже — подходы к планированию для типичных задач агента. Столбец «Рекомендуемая стратегия» в таблице — это инженерная практика, а не спецификация из документации.
| Тип задачи | Точка входа | Планируемый верхний лимит (по документации) | Рекомендуемая стратегия |
|---|---|---|---|
| Анализ кода всего репозитория | API | 1,048,576 токенов |
Сначала найти релевантные файлы, затем передавать их целиком, оставляя запас |
| Разбор длинных логов | API | 1,048,576 токенов |
Разбивать по временным окнам, повторяющийся префикс передавать через кэшируемый ввод |
| Многошаговый рефакторинг в IDE | Antigravity | до 512K токенов |
Периодически суммировать историю и отбрасывать старые выводы инструментов |
| Длительные задачи агента с несколькими инструментами | Antigravity | до 512K токенов |
Декомпозировать на подзадачи и записывать структурированную память после каждого сегмента |
| Повторное использование одного процесса в разных точках входа | Оба варианта | 512K как общий верхний лимит |
Проектировать под меньшее окно — тогда процесс запустится и через API |
Именно последнюю строку чаще всего упускают. Если одна и та же логика агента должна работать и в Antigravity, и через API, надёжнее всего проектировать общий процесс под 512K. Тогда он запустится и через API — просто контекстное окно не будет использовано полностью. Если же проектировать под 1M, при переходе в Antigravity придётся переписывать логику сегментации.
Когда вы записываете цифры окна в план, лучше использовать формат «число + источник + точка входа», например: «Документация модели Antigravity: Gemini 4 Neon — до 512K токенов, уровень мышления по умолчанию — High». На ревью сразу видно, к какой точке входа относится эта цифра, а при обновлении документации удобно проверять всё по пунктам.

Часто задаваемые вопросы (FAQ)
Q1: Насколько велико контекстное окно Gemini 4 Neon на самом деле?
Всё зависит от того, куда вы обращаетесь. В анонсе Gemini API / Google от 2026-11-18 указано единое контекстное окно в `1,048,576` token, а в документации моделей Antigravity — максимум `512K` token. Обе цифры — оригинальный текст Google, и каждая относится к своей точке входа.
Q2: 1M у API и 512K у Antigravity — это противоречие?
Нет, не противоречие. Два документа описывают разные продуктовые поверхности, опубликованы на одной неделе, и страницы друг на друга не ссылаются. Проблема возникает только в планах: если брать цифры из API и планировать по ним задачи в Antigravity, вот тогда всё сломается.
Q3: Можно ли считать выложенные в сети логи вызовов инструментов основанием для размера окна?
Нет. В статье OrcaRouter от 2026-11-19 говорится, что лог вызовов инструментов, опубликованный @kimmonismus 18 ноября, — это сторонний пост, а не описание окна от Google. Цифры окна стоит брать только из анонсов и страниц документации Google.
Q4: У Carbon тоже 1,048,576 — можно ли перенести это на Neon в Antigravity?
Нет. `1,048,576` на странице модели Carbon — это API-окно самого Carbon. Модель другая, точка входа другая, не совпадает ни по одному параметру, так что для Neon в Antigravity по-прежнему планируйте исходя из максимума 512K, указанного в его документации.
Q5: Как быстро вызвать Gemini 4 Neon через API?
1. Зарегистрируйтесь на APIYI apiyi.com и получите API-ключ и бесплатный тестовый лимит
2. Укажите в SDK `base_url` равным `https://api.apiyi.com/v1`
3. В поле модели впишите `gemini-4-neon`, а фактический расход проверяйте по полю `usage`
Так вы идёте через API, и окно планируется по `1,048,576` token из анонса Google.
Q6: В сводной таблице моделей нет gemini-4-neon — откуда тогда брать цену?
Ориентируйтесь на интерфейс цен. В версии сводной таблицы от 2026-11-19 этой модели ещё нет, а в интерфейсе цен она уже присутствует: в пересчёте выходит `$3` за вход, `$0.15` за чтение из кеша и `$15` за выход — совпадает с ценой у Google. Если нужно сверить, просто запросите интерфейс цен APIYI apiyi.com.
Q7: Влияет ли уровень размышлений по умолчанию в Antigravity на планирование?
Да, влияет. В документации прямо сказано, что по умолчанию стоит уровень High, и если не менять настройки, всё работает именно на нём. Уровень размышлений влияет на затраты на рассуждения и на время ответа, поэтому бюджет нужно считать по фактически используемому уровню; как именно это учитывается — смотрите в документации Antigravity.
Q8: На какие ограничения у Gemini 4 Neon стоит обратить внимание?
— Окно зависит от точки входа, единого универсального числа не существует
— Длинный ввод повышает стоимость и задержку, и большое окно вовсе не значит, что его нужно каждый раз заполнять целиком
— Документация может обновляться, поэтому в планах указывайте источник цифр и дату сверки
Gemini 4 Neon: ключевые моменты
- Оба числа взяты из официальных текстов: в анонсе API указано
1,048,576token, в документации Antigravity — максимум 512K token - Сначала определите входную точку, потом пишите число: откуда уходит запрос — на ту документацию и ссылайтесь
- Режим размышления по умолчанию — High: в Antigravity без изменения настроек он High, бюджет считайте по нему
- Посты третьих лиц — не спецификация: записи вызовов инструментов не заменяют описание окна от Google
- Окна моделей нельзя переносить друг на друга: API-окно Carbon нельзя применить к Neon в Antigravity
- При работе в нескольких входных точках ориентируйтесь на меньшее окно: процесс, который должен работать в обоих местах, проектируйте исходя из 512K
- Цены сверяйте через интерфейс ценообразования: при вызове
gemini-4-neonчерез APIYI калибруйте бюджет по полюusage
Итоги
Ключевые моменты планирования контекста для Gemini 4 Neon:
- Входная точка определяет окно: для API —
1,048,576token, для Antigravity — максимум 512K token, каждый со своим источником - Порядок проверки фиксирован: сначала подтвердите входную точку, затем значение режима размышления по умолчанию, и только потом вписывайте число окна в план
- Калибруйте по реальному расходу: ориентируйтесь на возвращаемый
usage, а для контроля затрат используйте сегментирование, суммаризацию и кэширование входа
Когда пишете план для агента, объединяйте «число + источник + входную точку» в единое целое — так вы не станете планировать 1M для входной точки, где доступно только 512K. Рекомендую прогнать реальный материал на gemini-4-neon через APIYI apiyi.com, получить данные о расходе и только потом финализировать проект. Платформа предоставляет бесплатный лимит и единый интерфейс для множества моделей.
📚 Справочные материалы
-
Gemini API / объявление Google (2026-11-18): унифицированный контекст Gemini 4 Neon и прайс-лист API
- Пояснение: первоисточник данных об окне в
1,048,576токенов и о ценах на вход, кэшированный вход и выход
- Пояснение: первоисточник данных об окне в
-
Документация моделей Antigravity: контекст и уровни рассуждений Gemini 4 Neon в Antigravity
- Ссылка:
antigravity.google/docs/models - Пояснение: источник данных о максимуме в 512K токенов и об уровнях рассуждений Low, Medium, High (по умолчанию) и Extra
- Ссылка:
-
Статья OrcaRouter (2026-11-19): указывает на расхождение в цифрах окна между двумя документами
- Пояснение: там же объясняется, что записи вызовов сторонних инструментов нельзя использовать как описание окна
-
Сводная таблица моделей и интерфейс цен APIYI: точка сверки моделей и цен
- Пояснение: см. два адреса в разделе «Шаг третий: сверка модели и цены» выше; для
gemini-4-neonориентируйтесь на интерфейс цен
- Пояснение: см. два адреса в разделе «Шаг третий: сверка модели и цены» выше; для
Автор: техническая команда APIYI
Техническая связь: пишите нам через главную страницу сайта APIYI, а больше материалов ищите в центре документации docs.apiyi.com
