Gemini 4 Hydrogen

Используйте gemini-4-hydrogen с нативным форматом Gemini. На странице модели есть Playground и актуальные цены. Gemini 4 Hydrogen использует тот же формат запроса, что и Gemini 4 Argon; согласно руководству Google, для перехода между ними достаточно изменить идентификатор модели.

Идентификатор модели

Перед запуском примеров проверьте список моделей и доступные вам тарифы. Если тариф Default недоступен, используйте полный идентификатор вызова, возвращённый обнаружением.

Быстрый пример

curl https://api.seedrouter.ai/v1beta/models/gemini-4-hydrogen:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

Модель указывается в URL. Поле contents обязательно. Ответ содержит нативные candidates, finishReason и usageMetadata; сохраняйте полные части содержимого, включая thoughtSignature, для истории диалога. Сложные запросы могут выполняться несколько минут. Google рекомендует тайм-аут клиента 20 минут. Используйте потоковую передачу, чтобы получать вывод по мере готовности.

Конечные точки

Спецификация OpenAPI содержит все вложенные схемы запросов и ответов. Если необязательные поля опущены, используются значения API по умолчанию. Публичный нативный API сохраняет переданное тело для проверки Gemini. Playground также проверяет документированные ограничения перед отправкой и применяет свои настройки безопасности.

Параметры запроса

URL фиксирует модель gemini-4-hydrogen. Контракт запроса содержит 11 полей верхнего уровня. Поля необязательны, если не помечены как обязательные; отсутствие поля отличается от JSON null. Произвольный JSON, допускающий null, сохраняется там, где это разрешено официальной схемой.

Явное кэширование контекста (ресурсы cachedContent и cachedContents) не поддерживается в Gemini 4 Hydrogen. Неявное кэширование включено по умолчанию для запросов длиной не менее 4 096 токенов.

Параметры генерации

Документ OpenAPI перечисляет вложенные типы, перечисления, обязательные свойства и документированные границы для каждого сообщения. Схемы описывают официальные параметры, а не список разрешённых полей запроса SeedRouter. Поля и значения, переданные вызывающей стороной, сохраняются. Принятие поля схемой не доказывает поддержку для каждого аккаунта. Уровень рассуждений minimal не указан в списке. Google сообщает, что temperature, topP, topK и candidateCount устарели, и рекомендует их удалить; пользовательские значения сэмплирования игнорируются. При передаче в нативном JSON они по-прежнему проходят без изменений для обработки API Gemini.

Поэтапная генерация длинного ответа

Один ответ Gemini 4 Hydrogen возвращает до 65 536 токенов с потоковой передачей и до 65 536 токенов без неё. Для более длинного вывода задайте maxOutputTokens выше 65 536 и продолжайте ответ самостоятельно:

1. Отправьте запрос. Если ответ заканчивается с finishReason: "CONTINUATION", прочитайте candidates[0].continuationToken.
2. Отправьте тот же запрос повторно с этим значением в поле верхнего уровня continuationToken. Не добавляйте частичный вывод в contents; токен несёт состояние модели, включая её рассуждения.
3. Повторяйте, пока finishReason не станет STOP или MAX_TOKENS.

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "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 и объявленных имён.

Ваше приложение выполняет возвращённые функции и передаёт их результаты в следующем ходе диалога. Сохраняйте каждую исходную thoughtSignature, вызов функции и ответ функции. Не округляйте числовые идентификаторы при сериализации непрозрачных аргументов функций.

Google указывает для этой модели Search, Maps, выполнение кода, URL context, File Search и Computer Use. Ресурсы File Search требуют доступа с учётными данными, обслуживающими запрос. Нативная конфигурация MCP присутствует в общей схеме, но её доступность для этой модели не установлена. Проверьте официальные ограничения каждого инструмента, прежде чем сочетать его с медиа. При grounding Google учитывает внутренние инструкции инструментов и объявления функций как входные токены. Playground не выполняет ваши пользовательские функции.

Мультимодальный ввод и безопасность

Элемент contents[].parts[] содержит ровно одну полезную нагрузку: текст, встроенные медиа, ссылку на файл, вызов или ответ функции либо часть выполнения. Он также может содержать подпись или метаданные медиа. Ввод поддерживает текст, изображения, аудио, видео и PDF; вывод — только текст. У модели нет генерации изображений или аудио и нет Live API.

Для встроенных байтов используйте inlineData.mimeType и data в base64. Для ссылок на файлы используйте fileData.mimeType и fileUri. Синтаксически корректный URL не доказывает, что модель может получить его содержимое. Метаданные видео могут задавать начальное и конечное смещения и положительный fps не выше 24. Агентное понимание видео выбирается для каждой части через mediaProcessing: "AGENTIC" рядом с fileData или inlineData видео; по умолчанию обработка статическая. videoMetadata содержит только startOffset, endOffset и fps.

Настройки безопасности используют официальный нативный формат и проходят через 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. Hydrogen по умолчанию использует уровень рассуждений high. Задавайте уровень явно, сравнивая использование с другой моделью.

Для этой модели нет ценовой ступени по длине контекста. Актуальные цены SeedRouter используют ставки за токены Standard; скидки Flex и надбавки Priority для этой интеграции не настроены. Поддержка этих уровней обработки ещё требует проверки. Grounding Google Search может добавлять плату за каждый поисковый запрос сверх расхода токенов; проверьте цены инструментов перед включением. Неудачные запросы не оплачиваются. См. таблицу актуальных цен.

Группы аккаунта

Тариф Default использует базовый идентификатор модели gemini-4-hydrogen. Дополнительные тарифы используют gemini-4-hydrogen: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-hydrogen" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

Статус проверки

Официальная документация проверена 13 ноября 2026 года. В этот день успешно прошли три платные проверки через SeedRouter с одной попыткой каждая: структурированный JSON с размышлениями low, SSE с размышлениями xhigh и вызов объявленной функции с размышлениями low. Сообщённые токены ввода, вывода и размышлений соответствовали записанной плате по опубликованным тарифам. Понимание медиа, привязка к источникам, Computer Use, продолжение/длинное декодирование, другие общие поля и уровни обработки остаются непроверенными. Эти проверки не устанавливают сравнительное качество или задержку.

Источники

• Спецификация модели Google
• Что нового в Gemini 4 Hydrogen
• Поэтапная генерация длинного ответа с generateContent
• Рассуждения
• Цены
• Справочник REST GenerateContent