Text
Gemini 4 Neon
Нативные запросы Gemini, четыре уровня рассуждений, поэтапная генерация длинного ответа с токенами продолжения, инструменты, мультимодальный ввод и потоковая выдача. Ограничения модели и статус проверки.
Используйте gemini-4-neon с нативным форматом Gemini. На странице модели есть Playground и актуальные цены. Gemini 4 Neon расположена между Gemini 4 Hydrogen и Gemini 4 Carbon и использует тот же нативный формат запроса generateContent; согласно руководству Google по миграции, переход между моделями Gemini 4 не требует изменений схемы запроса.
Идентификатор модели
| Идентификатор модели | Контекстное окно | Усилие по умолчанию |
|---|---|---|
gemini-4-neon | 1 048 576 токенов, общих для входа, рассуждений и выхода | high |
Используйте gemini-4-neon для тарифа Default или выберите явный тариф gemini-4-neon:GROUP_NAME, возвращённый обнаружением моделей. Перед отправкой запросов проверьте доступные вам тарифы.
Быстрый пример
curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'Модель указывается в URL. Поле contents обязательно. Ответ содержит нативные candidates, finishReason и usageMetadata; сохраняйте полные части содержимого, включая thoughtSignature, для истории диалога. Сложные запросы могут выполняться несколько минут. Google рекомендует тайм-аут клиента 20 минут. Используйте потоковую передачу, чтобы получать вывод по мере готовности.
Конечные точки
| Операция | Конечная точка |
|---|---|
| Ответ JSON | POST /v1beta/models/gemini-4-neon:generateContent |
| События, отправляемые сервером | POST /v1beta/models/gemini-4-neon:streamGenerateContent?alt=sse |
Спецификация OpenAPI содержит все вложенные схемы запросов и ответов. Если необязательные поля опущены, используются значения API по умолчанию. Публичный нативный API сохраняет переданное тело для проверки Gemini. Playground также проверяет документированные ограничения перед отправкой и применяет свои настройки безопасности.
Параметры запроса
URL фиксирует модель gemini-4-neon. Контракт запроса содержит 11 полей верхнего уровня. Поля необязательны, если не помечены как обязательные; отсутствие поля отличается от JSON null. Произвольный JSON, допускающий null, сохраняется там, где это разрешено официальной схемой.
| Поле | Тип | Обязательно | Значение по умолчанию и ограничения |
|---|---|---|---|
contents | object[] | Да | Непустой диалог; каждый элемент содержимого имеет непустой parts |
systemInstruction | object | Нет | Только текстовые части; идентификационные данные пользователя автоматически не вставляются |
generationConfig | object | Нет | Параметры генерации в следующей таблице |
tools | object[] | Нет | Объявления функций и конфигурации встроенных инструментов |
toolConfig | object | Нет | Конфигурация выбора функций и поиска |
safetySettings | object[] | Нет | Одна настройка на категорию; дублирование категорий запрещено |
serviceTier | string | Нет | unspecified, standard, flex, priority; обычная обработка — standard |
continuationToken | string | Нет | Токен, возвращаемый с finishReason: CONTINUATION или MAX_TOKENS; отправьте тот же запрос с ним повторно, чтобы продолжить длинный ответ |
labels | object | Нет | Строковые значения; ключи и значения в нижнем регистре, максимум по 63 кодовые точки Unicode |
model | string | Нет | Необязательное имя ресурса; фактическую модель определяет URL |
store | boolean | Нет | Общее предпочтение хранения запроса; эффект для этой модели не проверен |
Явное кэширование контекста (ресурсы cachedContent и cachedContents) не поддерживается в Gemini 4 Neon. Неявное кэширование включено по умолчанию для запросов длиной не менее 4 096 токенов.
Параметры генерации
Поле в generationConfig | Тип | Значение по умолчанию и ограничения |
|---|---|---|
maxOutputTokens | integer | По умолчанию 65 536, включая рассуждения. До 1 048 576 за вычетом входа с продолжением. Каждый потоковый или непотоковый ответ поддерживает до 65 536 токенов; для более длинного вывода используйте продолжение |
thinkingConfig | object | thinkingLevel: low, medium, high, xhigh (по умолчанию high); допустимо написание в верхнем регистре. includeThoughts: boolean, по умолчанию false. Используйте thinkingLevel; устаревший thinkingBudget, если передан отдельно, преобразуется в уровень с предупреждением и не может сочетаться с thinkingLevel |
stopSequences | string[] | Максимум пять последовательностей |
responseMimeType | string | По умолчанию text/plain; вывод по прежней схеме JSON требует application/json |
responseSchema | object | Официальный диалект схемы; взаимоисключение с responseJsonSchema |
responseJsonSchema | JSON | JSON Schema; взаимоисключение с responseSchema |
responseFormat | object | Конфигурация текстового формата; text.mimeType и необязательный text.schema. Схема требует MIME-тип JSON |
responseModalities | string[] | Только текст: TEXT; пустое значение означает текст |
mediaResolution | enum | MEDIA_RESOLUTION_UNSPECIFIED, LOW, MEDIUM, HIGH с префиксом MEDIA_RESOLUTION_ |
seed | integer | Знаковое 32-битное значение; детерминированное поведение этой модели не проверено |
presencePenalty | number | Общее поле; эффект и диапазон для этой модели не проверены |
frequencyPenalty | number | Общее поле; эффект и диапазон для этой модели не проверены |
responseLogprobs | boolean | Общее поле; доступность для этой модели не проверена |
logprobs | integer | 0–20; требует responseLogprobs: true; поддержка моделью не проверена |
enableEnhancedCivicAnswers | boolean | Общее поле; поддержка моделью не проверена |
enableAffectiveDialog | boolean | Общее поле; поддержка моделью не проверена |
audioTranscriptionConfig | object | Общее поле; варианты для этой модели не проверены |
translationConfig | object | Общее поле; варианты для этой модели не проверены |
Документ OpenAPI перечисляет вложенные типы, перечисления, обязательные свойства и документированные границы для каждого сообщения, включая audioMetadata, documentMetadata, spreadsheetMetadata и videoMetadata.contentLayers из спецификации обнаружения v1beta. Схемы описывают официальные параметры, а не список разрешённых полей запроса SeedRouter. Поля и значения, переданные вызывающей стороной, сохраняются. Принятие поля схемой не доказывает поддержку для каждого аккаунта. Уровень рассуждений minimal не указан в списке. Google сообщает, что temperature, topP, topK и candidateCount устарели и их следует удалить; пользовательские значения сэмплирования в допустимом диапазоне игнорируются, а значения вне диапазона возвращают 400. При передаче в нативном JSON они по-прежнему проходят без изменений для обработки API Gemini.
Поэтапная генерация длинного ответа
Один ответ Gemini 4 Neon возвращает до 65 536 токенов с потоковой передачей и до 65 536 токенов без неё. Для более длинного вывода задайте maxOutputTokens выше 65 536 и продолжайте ответ самостоятельно:
- Отправьте запрос. Если ответ заканчивается с
finishReason: "CONTINUATION", прочитайтеcandidates[0].continuationToken. - Отправьте тот же запрос повторно с этим значением в поле верхнего уровня
continuationToken. Не добавляйте частичный вывод вcontents; токен несёт состояние модели, включая её рассуждения. - Повторяйте, пока
finishReasonне станетSTOPилиMAX_TOKENS. Если вызов достигMAX_TOKENSи вернулcontinuationToken, продолжить можно только увеличивmaxOutputTokens; повтор с тем же лимитом возвращает400 INVALID_ARGUMENT.
{
"contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
"generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
"continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}Раунд запроса, целиком потраченный на рассуждения, может вернуть пустой текст с CONTINUATION; это нормальный ход работы. Каждый раунд повторно отправляет модели ваш запрос и всё сгенерированное к этому моменту, поэтому входные токены повторно учитываются в каждом последующем раунде (при этом повторяющиеся префиксы подходят для неявного кэширования). SeedRouter тарифицирует каждый раунд как отдельный запрос. Серверный режим background API Interactions не входит в эту конечную точку.
Структурированный вывод
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 65536,
"responseMimeType": "application/json",
"responseJsonSchema": {
"type": "object",
"properties": {"ok": {"type": "boolean"}},
"required": ["ok"]
}
}
}Прежние поля responseSchema и responseJsonSchema нельзя использовать вместе. Оба требуют responseMimeType: "application/json". Более новая схема responseFormat.text также должна указывать JSON. Используйте написание перечислений REST (APPLICATION_JSON и TEXT_PLAIN) в этом сообщении. Запросы проходят без изменений; MIME-типы медиа и произвольный JSON функций не переписываются.
Функции и встроенные инструменты
Используйте tools[].functionDeclarations с именем и либо parameters, либо parametersJsonSchema, но не обоими. Выбор функций находится в toolConfig.functionCallingConfig; allowedFunctionNames требует ANY или VALIDATED и объявленных имён. Не просите модель через системные инструкции выводить вызовы инструментов в виде сырого JSON-текста без объявленных инструментов — это может вернуть MALFORMED_FUNCTION_CALL.
Ваше приложение выполняет возвращённые функции и передаёт их результаты в следующем ходе диалога. Сохраняйте каждую исходную thoughtSignature, вызов функции и ответ функции. Не копируйте подпись рассуждений между параллельными частями functionCall и не округляйте числовые идентификаторы при сериализации непрозрачных аргументов функций.
Google указывает для Gemini 4 Neon Search, Maps, выполнение кода, URL context, File Search и Computer Use. Ресурсы File Search требуют доступа с учётными данными, обслуживающими запрос. Нативная конфигурация MCP присутствует в общей схеме, но её доступность для этой модели не установлена. Проверьте официальные ограничения каждого инструмента, прежде чем сочетать его с медиа. При grounding Google учитывает внутренние инструкции инструментов и объявления функций как входные токены. Playground не выполняет ваши пользовательские функции.
Мультимодальный ввод и безопасность
Элемент contents[].parts[] содержит ровно одну полезную нагрузку: текст, встроенные медиа, ссылку на файл, вызов или ответ функции либо часть выполнения. Он также может содержать подпись или метаданные медиа (videoMetadata, audioMetadata, documentMetadata, spreadsheetMetadata, mediaResolution, mediaProcessing). Ввод поддерживает текст, изображения, аудио, видео и PDF; вывод — только текст. У модели нет генерации изображений или аудио и нет Live API.
Для встроенных байтов используйте inlineData.mimeType и data в base64. Для ссылок на файлы используйте fileData.mimeType и fileUri. Синтаксически корректный URL не доказывает, что модель может получить его содержимое. Метаданные видео могут задавать startOffset, endOffset, положительный fps не выше 24 и contentLayers. Агентное понимание видео выбирается для каждой части через mediaProcessing: "AGENTIC" рядом с fileData или inlineData видео; по умолчанию обработка статическая.
Настройки безопасности используют официальный нативный формат и проходят через API без изменений. В Playground все четыре категории должны иметь значение BLOCK_MEDIUM_AND_ABOVE или более строгое; более низкие пороги доступны только через API.
Ответы JSON и потоковая передача
generateContent возвращает нативный JSON. streamGenerateContent?alt=sse выдаёт нативный JSON в событиях SSE data:. Важные поля: candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId и usageMetadata.
Сохраняйте полное нативное содержимое в истории диалога. Сводки рассуждений — не то же самое, что подписи рассуждений. Разрыв соединения не доказывает ни неудачу, ни завершение генерации; изучите частичный результат и запись аккаунта перед отправкой ещё одного запроса. Использование в потоке накопительное, поэтому берите последние счётчики, а не суммируйте все фрагменты.
Использование и цены
promptTokenCount включает кэшированный вход. cachedContentTokenCount оплачивается по тарифу кэшированного входа, а не повторно как некэшированный вход. Оплачиваемый вывод включает candidatesTokenCount и thoughtsTokenCount. Gemini 4 Neon по умолчанию использует уровень рассуждений high. Задавайте уровень явно, сравнивая использование с другой моделью.
Для этой модели нет ценовой ступени по длине контекста. Актуальные цены SeedRouter используют ставки за токены Standard; скидки Flex и надбавки Priority для этой интеграции не настроены. Поддержка этих уровней обработки ещё требует проверки. Grounding Google Search может добавлять плату за каждый поисковый запрос сверх расхода токенов; проверьте цены инструментов перед включением. Неудачные запросы не оплачиваются. См. таблицу актуальных цен.
Группы аккаунта
Тариф Default использует базовый идентификатор модели gemini-4-neon. Дополнительные тарифы используют gemini-4-neon:GROUP_NAME в URL. Playground выбирает доступный тариф; API также принимает явный заголовок:
X-SeedRouter-Group: GROUP_NAMEВыбранная группа определяет цену и доступную ёмкость; явный выбор не переключается незаметно на другую группу. Опустите заголовок или используйте auto, чтобы сохранить поведение API-ключа по умолчанию.
Проверьте доступные API-ключу группы без генерации ответа:
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-neon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"Статус проверки
Официальная документация и ревизия обнаружения REST 20261119 проверены 20 ноября 2026 года. В этот день обнаружение моделей в режиме только для чтения (GET /v1/models), обнаружение групп (GET /api/seedrouter/llm/groups?model=gemini-4-neon) и публичные цены (GET /v1/pricing) подтвердили как тариф Default gemini-4-neon, так и явный тариф gemini-4-neon:googlellm-vertext. Три платных контрольных вызова через api.seedrouter.ai с одной попыткой каждый также завершились с кодом HTTP 200: генерация JSON с рассуждениями low на тарифе Default (54 токена запроса, 28 токенов вывода и 39 токенов рассуждений), потоковая передача SSE с рассуждениями xhigh на тарифе Default (50 токенов запроса, 13 токенов вывода и 207 токенов рассуждений) и объявленный functionCall с рассуждениями low на gemini-4-neon:googlellm-vertext (95 токенов запроса, 22 токена вывода и 49 токенов рассуждений с возвратом thoughtSignature). Сквозная передача нативного тела запроса и список разрешённых полей ответа требуют развёртывания обновлённой сборки бэкенда. Понимание медиа, grounding, Computer Use, продолжение/длинное декодирование, другие общие поля и уровни обработки остаются непроверенными, а эти проверки не устанавливают сравнительное качество или задержку.
