Gemini 3.8 Flash

Используйте gemini-3.8-flash в нативном формате Gemini. На странице модели доступны Playground и актуальные цены; руководство по сравнению моделей сопоставляет документированные настройки с Gemini 3.1 Pro.

ID модели

Краткий пример

curl https://api.seedrouter.ai/v1beta/models/gemini-3.8-flash: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":1024}}'

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

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

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

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

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

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

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

Структурированный вывод

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 1024,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Старые поля responseSchema и responseJsonSchema нельзя использовать вместе. Оба требуют responseMimeType: "application/json". Новая схема responseFormat.text также должна указывать JSON. В этом сообщении используйте написание enum из REST (APPLICATION_JSON и TEXT_PLAIN). Запросы передаются без изменений; MIME-типы медиа и произвольный JSON функций не переписываются.

Функции и встроенные инструменты

Используйте tools[].functionDeclarations с именем и одним из полей parameters или parametersJsonSchema, но не обоими. Для схем ответов действует то же правило взаимоисключения. Выбор функций задаётся в toolConfig.functionCallingConfig; allowedFunctionNames требует ANY или VALIDATED и объявленных имён.

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

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

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

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

Для встроенных байтов используйте inlineData.mimeType и base64 data. Для ссылок на файлы — fileData.mimeType и fileUri. Синтаксически корректный URL не доказывает, что модель может получить его содержимое. Метаданные видео могут задавать смещения начала и конца и положительный fps не выше 24. Глобальное разрешение медиа и разрешение отдельной части — разные настройки. Agentic Video поддерживается через videoMetadata.processingMode: "AGENTIC".

Используйте нативный JSON для встроенных медиа или доступную ссылку на файл для более крупных материалов. Точные ограничения форматов, длительности и объёма медиа на запрос определяются официальной документацией по медиа и требуют проверки на реальных запросах.

Настройки безопасности используют официальный нативный формат. При их отсутствии действуют значения Gemini API по умолчанию; явно переданные настройки проходят без изменений.

Ответы JSON и потоковая передача

generateContent возвращает нативный JSON. streamGenerateContent?alt=sse передаёт нативный JSON в событиях SSE data:. Основные поля: candidates[].content.parts, finishReason, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId и usageMetadata.

Сохраняйте нативное содержимое целиком в истории диалога. Краткие изложения рассуждений отличаются от подписей рассуждений. Обрыв соединения не доказывает ни сбой, ни завершение генерации; перед новым запросом проверьте частичный результат и записи аккаунта. Счётчики использования в потоке накопительные: используйте последние значения, не складывайте все фрагменты.

Продолжение длинного вывода для Gemini 3.8 Flash не подтверждено. Не создавайте цикл продолжения лишь потому, что общая схема ответа содержит поле токена.

Использование токенов и цены

promptTokenCount включает кэшированный вход. cachedContentTokenCount оплачивается по тарифу кэшированного входа и не начисляется повторно как некэшированный вход. Оплачиваемый выход включает candidatesTokenCount и thoughtsTokenCount. Указанные в ответе входные токены использования инструментов также входят во вход.

У этой модели нет ценовой ступени длинного контекста на 200,000 токенов. Доступные группы аккаунтов используют одно ценовое выражение модели и собственный текущий множитель. См. таблицу актуальных цен.

Flex и Priority — отдельные уровни обработки. Flex использует половину тарифов Standard на вход, выход и кэшированный вход; Priority — 1.8 от этих тарифов. Опубликованные вводные тарифы Google действуют до 31 декабря 2026 года; всегда проверяйте текущую таблицу SeedRouter, не предполагая будущую цену. Результат с указанным Standard не должен оплачиваться с надбавкой Priority. Если при запросе Priority ответ не подтверждает фактический уровень, интеграция применяет тарифы токенов Standard. Плата за инструменты и явное хранение кэша начисляется отдельно от генерации токенов; общий бесплатный лимит инструментов не обещается. Неудачные запросы не оплачиваются.

Несколько групп аккаунтов

Модель использует googlellm и googlellm-vertext с сохранением существующих прав аккаунта и тарифов. Написание имён групп точное. Выберите доступную группу в Playground или используйте необязательный заголовок API:

X-SeedRouter-Group: googlellm

Для второй группы укажите googlellm-vertext. Выбранная группа определяет цену и доступную мощность; явный выбор не вызывает скрытого переключения на другую группу. Пропустите заголовок или укажите auto, чтобы сохранить стандартное поведение API-ключа.

Проверьте доступные вашему API-ключу группы без генерации ответа:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-3.8-flash"   -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

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

Элементы управления и документация следуют официальному нативному формату. Параметры проверяет Gemini API. Офлайн-проверки передачи и начисления платы не подтверждают доступность в рабочей среде. Реальная генерация, обе группы аккаунтов, понимание медиа, ресурсы кэша, встроенные инструменты и уровни обработки всё ещё требуют платной сквозной проверки. Измеренное сравнение качества или задержки с Gemini 3.1 Pro не заявляется.

Источники

• Спецификация модели Google
• Изменения Gemini 3.8
• Справочник REST GenerateContent
• Структурированный вывод
• Рассуждения
• Цены