Краткий ответ
При вызове моделей Gemini 4, таких какgemini-4-argon или gemini-4-hydrogen, если modelVersion в исходном ответе отличается от запрошенной модели, не помечайте задачу как успешно выполненную только потому, что был возвращён HTTP 200, и не выполняйте её немедленный автоматический повтор.
Сохраните ответ и запишите запрошенную модель, возвращённую модель, responseId и идентификатор бизнес-задачи. Пометьте задачу как needs_rerun. После завершения пакетной обработки сформируйте отчёт об исключениях и решите, следует ли выполнить повторный проход только для этих задач.
Как подтвердить условие
Нативный ответ GeminigenerateContent включает modelVersion и responseId на верхнем уровне:
gemini-4-argon, возвращённая модель является неожиданной. Отметьте это отдельно на уровне бизнес-логики, даже если текст выглядит нормально и finishReason имеет значение STOP.
- Без потоковой передачи: проверьте
modelVersionв полном ответе. - Потоковая передача: проверяйте каждый фрагмент, а не только первый. Публичные воспроизведения показывают, что более ранние фрагменты и последний фрагмент
STOPмогут сообщать о разных моделях при одном и том жеresponseId. - Формат, совместимый с OpenAI: не используйте поле
modelв ответе как замену этой проверке, поскольку обычно оно повторяет имя запрошенной модели. Если необходимо проверить модель, возвращённую провайдером, используйте нативный формат Gemini.
Рекомендуемый рабочий процесс
Проверяйте модель для каждого запроса
response.model_version == requested_model. Отсутствующее значение также требует маркера исключения, поскольку фактическую модель невозможно подтвердить; не считайте такой результат успешным по умолчанию.Подавайте предупреждение и сохраняйте исходный результат
Изолируйте задачу, не останавливая пакетную обработку
needs_rerun и продолжите обработку остальных задач. Отчёт о пакетной обработке должен содержать как минимум сводку по успешным задачам, аномалиям в данных о модели, другим сбоям и задачам, ожидающим повторного прохода.Выполните повторный проход после проверки
Пример проверки на Python
В этом примере используется SDKgoogle-genai. Он выполняет только один запрос и оставляет решение вызывающей пакетной программе; автоматические повторные попытки не выполняются:
needs_rerun имеет значение True, если набор пуст, содержит другую модель или содержит несколько моделей. Продолжайте собирать текст фрагмент за фрагментом, а finishReason и сведения об использовании проверяйте отдельно.
Что записывать в отчёт о пакете
responseId, временную отметку с часовым поясом и обезличенный запрос для воспроизведения. Не передавайте содержимое данных клиентов или полные бизнес-наборы данных.Часто задаваемые вопросы
Почему не стоит повторять запрос сразу после обнаружения несоответствия?
Почему не стоит повторять запрос сразу после обнаружения несоответствия?
Доказывает ли несовпадение значения, что ответ сгенерировала Flash-Lite?
Доказывает ли несовпадение значения, что ответ сгенерировала Flash-Lite?
Нужно ли всегда строго сравнивать названия моделей?
Нужно ли всегда строго сравнивать названия моделей?
latest, получение конкретной версии может быть нормальным поведением. Проверяйте соответствие явно заданному вами набору допустимых версий, а не применяйте правило для фиксированных идентификаторов.Что делать, если при втором проходе снова возвращается другая модель?
Что делать, если при втором проходе снова возвращается другая модель?
responseId затронутых запросов, названия запрошенных и возвращенных моделей, временные метки и запрос для воспроизведения проблемы с удаленными конфиденциальными данными, затем обратитесь в службу поддержки APIYI для расследования ситуации на стороне провайдера.