Перейти к основному содержанию

Краткий ответ

При вызове моделей Gemini 4, таких как gemini-4-argon или gemini-4-hydrogen, если modelVersion в исходном ответе отличается от запрошенной модели, не помечайте задачу как успешно выполненную только потому, что был возвращён HTTP 200, и не выполняйте её немедленный автоматический повтор. Сохраните ответ и запишите запрошенную модель, возвращённую модель, responseId и идентификатор бизнес-задачи. Пометьте задачу как needs_rerun. После завершения пакетной обработки сформируйте отчёт об исключениях и решите, следует ли выполнить повторный проход только для этих задач.
Это аномалия отчётности о модели или маршрутизации, которая может возникать на стороне провайдера Google. Это не означает, что ваш запрос нарушил политику или что статус вашей учётной записи был понижен. Само по себе modelVersion не может доказать, что ответ был сгенерирован с использованием других весов обслуживания, однако задачи, чувствительные к согласованности, не должны принимать результат как корректный вывод запрошенной модели.

Как подтвердить условие

Нативный ответ Gemini generateContent включает modelVersion и responseId на верхнем уровне:
Если запрос был выполнен для gemini-4-argon, возвращённая модель является неожиданной. Отметьте это отдельно на уровне бизнес-логики, даже если текст выглядит нормально и finishReason имеет значение STOP.
  • Без потоковой передачи: проверьте modelVersion в полном ответе.
  • Потоковая передача: проверяйте каждый фрагмент, а не только первый. Публичные воспроизведения показывают, что более ранние фрагменты и последний фрагмент STOP могут сообщать о разных моделях при одном и том же responseId.
  • Формат, совместимый с OpenAI: не используйте поле model в ответе как замену этой проверке, поскольку обычно оно повторяет имя запрошенной модели. Если необходимо проверить модель, возвращённую провайдером, используйте нативный формат Gemini.

Рекомендуемый рабочий процесс

1

Проверяйте модель для каждого запроса

Для фиксированного идентификатора модели используйте строгое сравнение: response.model_version == requested_model. Отсутствующее значение также требует маркера исключения, поскольку фактическую модель невозможно подтвердить; не считайте такой результат успешным по умолчанию.
2

Подавайте предупреждение и сохраняйте исходный результат

Зафиксируйте аномалию, не отбрасывая возвращённый текст или сведения об использовании. Результат помогает при диагностике, а одно лишь несоответствие модели не должно немедленно создавать второй платный запрос.
3

Изолируйте задачу, не останавливая пакетную обработку

Пометьте текущую задачу как needs_rerun и продолжите обработку остальных задач. Отчёт о пакетной обработке должен содержать как минимум сводку по успешным задачам, аномалиям в данных о модели, другим сбоям и задачам, ожидающим повторного прохода.
4

Выполните повторный проход после проверки

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

Пример проверки на Python

В этом примере используется SDK google-genai. Он выполняет только один запрос и оставляет решение вызывающей пакетной программе; автоматические повторные попытки не выполняются:
Для потоковых вызовов собирайте модель, указанную в каждом фрагменте, вместо того чтобы сохранять только последнее значение:
needs_rerun имеет значение True, если набор пуст, содержит другую модель или содержит несколько моделей. Продолжайте собирать текст фрагмент за фрагментом, а finishReason и сведения об использовании проверяйте отдельно.

Что записывать в отчёт о пакете

Никогда не записывайте API-ключи в журнал. При обращении в службу поддержки предоставьте запрошенную модель, возвращённую модель, responseId, временную отметку с часовым поясом и обезличенный запрос для воспроизведения. Не передавайте содержимое данных клиентов или полные бизнес-наборы данных.

Часто задаваемые вопросы

Немедленные повторные запросы увеличивают трафик и затраты и могут вызвать лавину повторных запросов, пока аномалия сохраняется. Сохранение данных первого прохода и изоляция затронутых задач перед вторым проходом с ограниченным числом попыток упрощают диагностику и учет. Если ваши бизнес-процессы требуют автоматических повторных запросов, задайте максимальное число попыток, задержку между ними и механизм размыкания цепи, а также сохраняйте каждый ответ.
По одному этому полю сделать вывод нельзя. Причиной может быть как фактическое изменение маршрутизации, так и аномалия в метаданных версии или учета использования. В любом случае для задач с жестким требованием использовать конкретную модель такой результат следует считать не прошедшим проверку соответствия модели.
Строгое равенство — наиболее однозначное правило для рассматриваемых здесь фиксированных идентификаторов моделей Gemini 4. Если вы намеренно используете псевдоним, например latest, получение конкретной версии может быть нормальным поведением. Проверяйте соответствие явно заданному вами набору допустимых версий, а не применяйте правило для фиксированных идентификаторов.
Прекратите дальнейшие автоматические повторные запросы и сохраните оба отчета. Соберите значения responseId затронутых запросов, названия запрошенных и возвращенных моделей, временные метки и запрос для воспроизведения проблемы с удаленными конфиденциальными данными, затем обратитесь в службу поддержки APIYI для расследования ситуации на стороне провайдера.

Связанные документы

Нативный разбор ответов Gemini

Непотоковая передача, потоковая передача, modelVersion, responseId и поля usage

Руководство по нативному API Gemini

SDK google-genai, нативный эндпоинт и конфигурация thinking

Примечания о переключении моделей Gemini 4 Carbon

Ранее наблюдавшееся поведение, влияние и рекомендации

Генерация текста Gemini 4 Argon

Идентификатор модели Argon, два эндпоинта и примеры вызовов