Text
Gemini 4 Argon
Нативные запросы Gemini, мультимодальный ввод, рассуждения, инструменты, потоковые ответы и продолжение. Указаны текущие пределы проверки.
Используйте gemini-4-argon в нативном формате Gemini. На странице модели доступны Playground и актуальные цены; в руководстве по выпуску описана доступность.
ID модели
| ID модели | Контекстное окно | Усилие по умолчанию |
|---|---|---|
gemini-4-argon | 1 048 576 токенов | medium |
Краткий пример
curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon:generateContent \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":256}}'Модель указывается в URL. Поле contents обязательно. Ответ содержит нативные candidates, finishReason и usageMetadata; сохраняйте части содержимого целиком, включая thoughtSignature, в истории диалога.
Конечные точки
| Операция | Эндпоинт |
|---|---|
| Ответ JSON | POST /v1beta/models/gemini-4-argon:generateContent |
| События сервера | POST /v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse |
Спецификация OpenAPI содержит все вложенные схемы запросов и ответов. Для пропущенных необязательных полей действуют значения API по умолчанию. Неизвестные и официально неподдерживаемые поля удаляются; недопустимые значения поддерживаемых полей по-прежнему вызывают ошибки.
Параметры
| Имя | Тип | Обязательный | По умолчанию | Примечания |
|---|---|---|---|---|
contents | object[] | Да | — | Обязательный массив диалога; parts содержит текст, медиа и результаты инструментов |
systemInstruction | object | Нет | — | Системная инструкция только в текстовом формате |
generationConfig | object | Нет | — | Бюджет вывода, рассуждения, структурированный вывод, остановка и настройки медиа |
tools | object[] | Нет | — | Определения функций и встроенных инструментов |
toolConfig | object | Нет | — | Выбор функций, настройки поиска и части серверных инструментов |
safetySettings | object[] | Нет | — | Уникальные пары категории и порога |
continuationToken | string | Нет | — | Непрозрачный токен продолжения из последнего кандидата |
serviceTier | enum | Нет | standard | unspecified, standard, flex, priority; по умолчанию standard |
labels | object | Нет | — | Ключи и значения меток в нижнем регистре, до 63 символов Unicode каждое |
store | boolean | Нет | — | Предпочтение по журналированию запроса; не предоставляет получение сохранённых диалогов |
model | string | Нет | — | Необязательное имя ресурса в теле; модель фиксируется в URL |
generationConfig включает maxOutputTokens, thinkingConfig, stopSequences, responseFormat, устаревшие responseMimeType/responseSchema/responseJsonSchema, responseModalities, mediaResolution, seed, presencePenalty, frequencyPenalty, responseLogprobs, logprobs, enableEnhancedCivicAnswers, enableAffectiveDialog, translationConfig и audioTranscriptionConfig. Для общих полей, поведение которых не подтверждено именно для этой модели, ещё требуется проверка возможностей.
- Уровни рассуждений:
low,medium,high; по умолчаниюmedium. Отключить рассуждения нельзя.includeThoughtsзапрашивает их краткое изложение. УстаревшийthinkingBudgetпринимается отдельно, но его нельзя сочетать сthinkingLevel. - Вход, рассуждения и выход делят 1 048 576 токенов.
maxOutputTokensвключает рассуждения; оставшийся контекст может уменьшить фактический бюджет. - В нативном REST предел и значение по умолчанию для выхода на один запрос — 32 768 токенов, а в потоке — 65 536. Для более длинного вывода используется продолжение. Официальная документация содержит противоречия о первых непотоковых запросах свыше 32 768 токенов; интеграция не применяет этот порог как лимит всей генерации.
- Не более пяти
stopSequences.logprobsпринимает значения от 0 до 20 и требуетresponseLogprobs: true. responseSchemaиresponseJsonSchemaвзаимно исключают друг друга и требуютresponseMimeType: "application/json". В новых запросах можно использоватьresponseFormat.text, как показано ниже.responseModalitiesможет содержать толькоTEXT. Temperature, top-p, top-k и количество кандидатов не являются действующими настройками Argon. ЯвныйcachedContent, генерация изображений и генерация речи не поддерживаются.
Структурированный вывод и инструменты
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 256,
"responseFormat": {
"text": {
"mimeType": "APPLICATION_JSON",
"schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
}
}
}
}Функции задаются через tools[].functionDeclarations. Для allowedFunctionNames нужны режим ANY или VALIDATED и объявленные имена. Сохраняйте исходный порядок вызовов функций, ответов и подписей. Google Search, Maps, выполнение кода, URL context, File Search и Computer Use входят в официальные возможности; доступ к ресурсам, стоимость и поведение нужно проверить для планируемой операции. Playground не выполняет инструменты локально.
Медиа и безопасность
Нативный parts принимает текст, изображения, аудио, видео и PDF через inlineData или fileData. Одна часть содержит один вариант полезной нагрузки, при необходимости — с подписями рассуждений и метаданными медиа. Глобальный mediaResolution и разрешение отдельной части — разные настройки. Видео поддерживает обработку STATIC и AGENTIC; videoMetadata.fps должен быть больше нуля и не превышать 24.
Playground принимает JSON-запросы до 12 MiB. Это транспортный лимит приложения, а не лимит медиа модели. Для больших медиа используйте ссылки на файлы, поддерживаемые вашим аккаунтом. Для файловых ресурсов и медиа, загружаемых извне, действуют разные официальные ограничения; их доступность здесь ещё не проверена.
Настройки безопасности публичного API следуют нативному контракту. Playground требует блокировки среднего или более строгого уровня для четырёх основных категорий безопасности; более низкие пороги доступны только через API, за исключением администраторов.
Потоковые ответы и продолжение
Читайте нативные события JSON из потока SSE. Сохраняйте все части, включая метаданные инструментов и рассуждений. Счётчики использования внутри одного потока накопительные: используйте последний объект использования, не суммируйте каждое событие.
Если кандидат возвращает continuationToken, сохраните его точно. При CONTINUATION повторно отправьте исходные contents, системную инструкцию, инструменты и настройки генерации с последним токеном на верхнем уровне. Не добавляйте частичный вывод в contents. При MAX_TOKENS увеличьте бюджет вывода перед продолжением. Playground подготавливает запрос продолжения для проверки и отправляет его только после повторного нажатия кнопки отправки.
Каждое продолжение — отдельный запрос со своим использованием и стоимостью. Сохраняйте контрольные точки при реализации переподключения; не считайте, что прерванный поток завершился. Нативный ответ сохраняется в Playground для просмотра всех полей.
Использование и текущий статус проверки
Входное использование включает кэшированный вход; оплачиваемый выход включает токены кандидатов и рассуждений. Смотрите текущие тарифы на странице модели и историю использования аккаунта. Неудачные запросы не оплачиваются.
Локальные проверки 14 октября 2026 года подтвердили потоковую выдачу текста, структурированный JSON, подписанные вызовы функций с возвратом результатов, выполнение кода, Google Search и URL context, понимание изображений, видео и PDF, вывод рассуждений и последовательности остановки. Аудио было принято, но часть тестового аудио была расшифрована неверно.
logprobs был явно отклонён. Запросы с maxOutputTokens: 32769 завершились ошибкой как в проверках JSON, так и в проверках SSE. И с действительным, и с недействительным continuationToken были получены ответы, поэтому корректное продолжение не подтверждено. Выбор уровня обслуживания и seed были приняты без доказательств их влияния. Maps, File Search, Computer Use, agentic video и ссылки на внешние файлы остаются непроверенными.
Эти ограниченные проверки не подтверждают все сочетания параметров или доступность в рабочей среде. Используйте нативный формат для полного контракта; совместимость с OpenAI — отдельное подмножество без поддержки long decode.
Источники
- Официальная спецификация модели
- Руководство по миграции GenerateContent
- Long decode и продолжение
- Структурированный вывод
Необязательный выбор группы LLM
Войдите в Playground этой модели, чтобы проверить доступные группы. Варианты зависят от прав вашей учётной записи и выбранной модели. Playground использует вашу сессию входа; вводить API-ключ не требуется.
При вызовах API сохраняются ваш API-ключ и ID модели. Чтобы выбрать группу, передайте её точное название в необязательном заголовке запроса X-SeedRouter-Group. Замените GROUP_NAME ниже на название из Playground. Не передавайте заголовок или укажите auto, чтобы сохранить поведение ключа по умолчанию.
X-SeedRouter-Group: GROUP_NAMEДля API-ключа с ограничениями может быть доступно меньше групп, чем в Playground. Запросы оплачиваются по ценам выбранной группы и не переключаются на другую группу, если выбранная недоступна. Эта настройка поддерживает вызовы LLM по HTTP, включая SSE; она не применяется к вызовам через WebSocket, а также к запросам изображений или видео.
Чтобы проверить доступные группы для конкретного API-ключа без генерации ответа модели, используйте этот эндпоинт только для чтения. data[].id — значение для заголовка; ratio — ценовой множитель учётной записи для этой группы. Запись auto отражает текущую оценку для выбора по умолчанию; её множитель равен null, если доступной группы по умолчанию нет. Доступность группы проверяется повторно при вызове модели.
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-argon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"