> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Что делать, если Gemini 4 сообщает о другой модели?

> Узнайте, как обрабатывать собственный ответ Gemini 4, в котором modelVersion отличается от запрошенной модели: создайте оповещение, сохраните responseId, изолируйте задачу и сформируйте список для повторной проверки.

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

При вызове моделей Gemini 4, таких как `gemini-4-argon` или `gemini-4-hydrogen`, если `modelVersion` в исходном ответе отличается от запрошенной модели, **не помечайте задачу как успешно выполненную только потому, что был возвращён HTTP 200, и не выполняйте её немедленный автоматический повтор**.

Сохраните ответ и запишите запрошенную модель, возвращённую модель, `responseId` и идентификатор бизнес-задачи. Пометьте задачу как `needs_rerun`. После завершения пакетной обработки сформируйте отчёт об исключениях и решите, следует ли выполнить повторный проход только для этих задач.

> [!WARNING]
>
> Это аномалия отчётности о модели или маршрутизации, которая может возникать на стороне провайдера Google. **Это не означает, что ваш запрос нарушил политику или что статус вашей учётной записи был понижен.** Само по себе `modelVersion` не может доказать, что ответ был сгенерирован с использованием других весов обслуживания, однако задачи, чувствительные к согласованности, не должны принимать результат как корректный вывод запрошенной модели.

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

Нативный ответ Gemini `generateContent` включает `modelVersion` и `responseId` на верхнем уровне:

```json theme={null}
{
  "candidates": [
    {
      "content": {
        "parts": [{ "text": "Example answer" }]
      },
      "finishReason": "STOP"
    }
  ],
  "modelVersion": "3.1-flash-lite-05-2026",
  "responseId": "example-response-id"
}
```

Если запрос был выполнен для `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`. Он выполняет только один запрос и оставляет решение вызывающей пакетной программе; автоматические повторные попытки не выполняются:

```python theme={null}
import json
import os
import sys

from google import genai
from google.genai import types

requested_model = "gemini-4-argon"
task_id = "task-001"

with genai.Client(
    api_key=os.environ["APIYI_API_KEY"],
    http_options=types.HttpOptions(base_url="https://api.apiyi.com"),
) as client:
    response = client.models.generate_content(
        model=requested_model,
        contents="Introduce yourself in one sentence",
    )

actual_model = response.model_version
needs_rerun = actual_model != requested_model
record = {
    "task_id": task_id,
    "requested_model": requested_model,
    "model_version": actual_model,
    "response_id": response.response_id,
    "needs_rerun": needs_rerun,
    "answer": response.text,
}

if needs_rerun:
    print(
        f"WARNING {task_id}: requested={requested_model}, "
        f"returned={actual_model}, response_id={response.response_id}; "
        "not retrying automatically",
        file=sys.stderr,
    )

print(json.dumps(record, ensure_ascii=False))
```

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

```python theme={null}
versions = set()
response_id = ""

for chunk in client.models.generate_content_stream(
    model=requested_model,
    contents="Introduce yourself in one sentence",
):
    if chunk.model_version:
        versions.add(chunk.model_version)
    if chunk.response_id:
        response_id = chunk.response_id

needs_rerun = versions != {requested_model}
```

`needs_rerun` имеет значение `True`, если набор пуст, содержит другую модель или содержит несколько моделей. Продолжайте собирать текст фрагмент за фрагментом, а `finishReason` и сведения об использовании проверяйте отдельно.

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

| Поле | Назначение |
| - | - |
| `task_id` или относительный путь к бизнес-файлу | Определить, для какой задачи требуется повторная обработка |
| `requested_model` | Точный идентификатор модели, отправленный в запросе |
| `model_version` | Модель, возвращённая в исходном ответе |
| `response_id` | Найти конкретный запрос вместе с его временной отметкой |
| `needs_rerun` / причина исключения | Сформировать целевой список для повторной обработки вместо повторного запуска всего пакета |
| Временная отметка с часовым поясом, задержка и tokens | Анализировать распределение аномалий и стоимость |
| Исходный текст и `finishReason` | Сохранять свидетельства и отличать аномалии модели от пустых или усечённых ответов |

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

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

> [accordion] Почему не стоит повторять запрос сразу после обнаружения несоответствия?
>
> Немедленные повторные запросы увеличивают трафик и затраты и могут вызвать лавину повторных запросов, пока аномалия сохраняется. Сохранение данных первого прохода и изоляция затронутых задач перед вторым проходом с ограниченным числом попыток упрощают диагностику и учет. Если ваши бизнес-процессы требуют автоматических повторных запросов, задайте максимальное число попыток, задержку между ними и механизм размыкания цепи, а также сохраняйте каждый ответ.

> [accordion] Доказывает ли несовпадение значения, что ответ сгенерировала Flash-Lite?
>
> По одному этому полю сделать вывод нельзя. Причиной может быть как фактическое изменение маршрутизации, так и аномалия в метаданных версии или учета использования. В любом случае для задач с жестким требованием использовать конкретную модель такой результат следует считать не прошедшим проверку соответствия модели.

> [accordion] Нужно ли всегда строго сравнивать названия моделей?
>
> Строгое равенство — наиболее однозначное правило для рассматриваемых здесь фиксированных идентификаторов моделей Gemini 4. Если вы намеренно используете псевдоним, например `latest`, получение конкретной версии может быть нормальным поведением. Проверяйте соответствие явно заданному вами набору допустимых версий, а не применяйте правило для фиксированных идентификаторов.

> [accordion] Что делать, если при втором проходе снова возвращается другая модель?
>
> Прекратите дальнейшие автоматические повторные запросы и сохраните оба отчета. Соберите значения `responseId` затронутых запросов, названия запрошенных и возвращенных моделей, временные метки и запрос для воспроизведения проблемы с удаленными конфиденциальными данными, затем обратитесь в службу поддержки APIYI для расследования ситуации на стороне провайдера.

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

> [card] [Нативный разбор ответов Gemini](https://docs.apiyi.com/ru/api-capabilities/gemini/response-handling.md)
>
> Непотоковая передача, потоковая передача, modelVersion, responseId и поля usage

> [card] [Руководство по нативному API Gemini](https://docs.apiyi.com/ru/api-capabilities/gemini/native.md)
>
> SDK google-genai, нативный эндпоинт и конфигурация thinking

> [card] [Примечания о переключении моделей Gemini 4 Carbon](https://docs.apiyi.com/ru/api-capabilities/gemini-4-carbon/overview.md)
>
> Ранее наблюдавшееся поведение, влияние и рекомендации

> [card] [Генерация текста Gemini 4 Argon](https://docs.apiyi.com/ru/api-capabilities/gemini-4-argon/overview.md)
>
> Идентификатор модели Argon, два эндпоинта и примеры вызовов


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.