Различия параметров и протоколов Gemini

Узнайте об отличиях параметров и использовании Gemini с совместимыми протоколами.

Настройте мысли, инструменты, кеш Gemini по этой странице. Структуры: Generate Content, Stream Generate Content, Chat Completions; нативные обычные и потоковые запросы имеют общие правила.

Модели

Модель	Особенности использования
gemini-4-argon	Нативные уровни `LOW/MEDIUM/HIGH`, по умолчанию `MEDIUM`; только неявный кеш, длинный вывод через продолжение
gemini-3.8-flash	Те же три уровня, по умолчанию `MEDIUM`, без нативного `MINIMAL`; явный и неявный кеш
gemini-3.7-flash	Три уровня, по умолчанию `MEDIUM`, без нативного `MINIMAL`. Google Developer API объявил модель устаревшей в пользу 3.8; это решение Google, не отключение или автозамена платформой

Отличия Generate Content

Поле	Отличие
`thinkingConfig.thinkingLevel`	Все три не выключают мысли через `MINIMAL` или старый нулевой бюджет; уменьшайте через `LOW`, не методом Gemini 2.5
`thinkingConfig.thinkingBudget`	Новые интеграции используют `thinkingLevel`, поля взаимоисключающие; Argon Developer API преобразует отдельный старый бюджет в ближайший уровень с предупреждением
`temperature/topP/topK`	Старые параметры семплирования игнорируются; не передавайте, они не меняют выборку
`candidateCount`	Gemini 3 и новее не поддерживают; удалить
`frequencyPenalty/presencePenalty`	Google Cloud 3.7 Flash указывает ошибку при передаче, не молчаливое игнорирование выше
`thinkingConfig.includeThoughts`	`parts[].thought` различает сводку и ответ; сводка не исходные мысли и не замена подписи
`parts[].thoughtSignature`	Сохраняйте все Parts без изменения; подписи обязательны в истории инструментов. Не объединяйте подписанные и неподписанные блоки
`functionCall/functionResponse`	Сопоставляйте `id`, `name` результатов с реальными вызовами по одному, включая все параллельные
Предзаполнение model	Не завершать незаконченной model; 3.8 также требует непустой текст в последнем user
`maxOutputTokens`	Мысли и ответ вместе. Прямой REST Argon: `32768` на обычный этап, `65536` на потоковый; для большего нужно продолжение, не просто большее число
`continuationToken`	Здесь продолжение только Argon: при `CONTINUATION` сохраняйте ввод, инструменты, общий бюджет и последний токен; после `MAX_TOKENS` бюджет выше использованных токенов. Не добавляйте промежуточный вывод в `contents`

Отличия Chat Completions

Правила официальной совместимости Google Chat, не обязательное поведение всех каналов платформы.

Поле	Отличие
`reasoning_effort`	Эти модели используют `low/medium/high`, по умолчанию `medium`; Argon также принимает `minimal` как `low`
`extra_body.google.thinking_config`	Настройки Gemini, включая `thinking_level`, `include_thoughts`; несовместимо с `reasoning_effort`
`tool_calls[].extra_content`	Сохраняйте `google.thought_signature` со всей историей инструментов; только имя и аргументы теряют подпись
`response_format`	Официальный структурированный JSON по подмножеству Gemini, не всем правилам OpenAI; нативные поля в Generate Content Reference
Продолжение длинного вывода	Официальный Chat Google не поддерживает длинное продолжение; используйте нативный Generate Content или Stream Generate Content

Отличия кеша

Поле	Отличие
Неявный кеш	Автоматически; Argon и 3.8 Flash требуют минимум `4096` одинаковых токенов префикса, без гарантии попадания
`cachedContent`	Argon отвергает создание/ссылки явного кеша; 3.8 Flash поддерживает, также 3.7 Flash в Google Cloud
Ссылки кеша Chat	Слой Google ссылается через `extra_body.google.cached_content`, не `prompt_cache_options` OpenAI; Chat не добавляет явный кеш Argon
Использование кеша	Проверяйте реальный нативный `usageMetadata.cachedContentTokenCount`, а не только включение настройки

Отличия мультимедийного ввода

Ввод	Блок протокола	Отличие
Изображение	Нативный `inlineData`	Base64 и правильный `mimeType`
Файл	Нативный `fileData`	Изображения, аудио, видео, PDF: URI доступен сервису, не локальный путь; нативные Files из соответствующего сервиса
Изображение	Chat `image_url`	Поддерживаемый URL изображения / Base64 Data URL, не нативные Parts
Аудио	Chat `input_audio`	Официальный пример: аудио Base64 с `format`, не настройка генерации аудио

Поле	Отличие
`mediaResolution`	Точность обработки ввода; структуры на уровне запроса и Part различны, индивидуальная переопределяет общую. Не разрешение выходной картинки
`responseModalities`	Все три выводят текст, `TEXT`; общие `IMAGE/AUDIO`, `imageConfig`, `speechConfig` не включают генерацию изображений/голоса

Примеры запросов

Замените MODEL_ID полным ID. Оба примера со средней глубиной и явным бюджетом, без автоматического продолжения.

curl 'https://api.agtcloud.cn/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "contents": [{"role": "user", "parts": [{"text": "Объясните в трёх пунктах, как диагностировать тайм-аут API"}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "MEDIUM"},
      "maxOutputTokens": 32768
    }
  }'