> ## 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 で異なるモデルが報告された場合の対処方法

> 要求したモデルと modelVersion が異なる Gemini 4 のネイティブレスポンスへの対処方法を説明します。アラートを発し、responseId を記録し、タスクを分離して、二次確認用のリストを作成します。

## 簡単な回答

`gemini-4-argon`や`gemini-4-hydrogen`などのGemini 4モデルを呼び出す際、ネイティブレスポンス内の`modelVersion`がリクエストしたモデルと異なる場合、**HTTP 200が返されたという理由だけでタスクを成功として扱わず、自動的にすぐ再試行しないでください**。

レスポンスを保持し、リクエストしたモデル、返されたモデル、`responseId`、および業務タスクIDを記録してください。タスクを`needs_rerun`としてマークします。バッチ完了後に例外レポートを作成し、それらのタスクのみを対象に2回目の処理を実行するかどうかを判断してください。

> [!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` を確認します。
* **ストリーミング:** 最初のチャンクだけでなく、すべてのチャンクを確認します。公開されている再現例では、同じ `responseId` でも、前半のチャンクと最後の `STOP` チャンクで異なるモデルが報告されることがあります。
* **OpenAI互換形式:** レスポンスの `model` フィールドをこの確認の代わりに使用しないでください。通常はリクエストされたモデル名をそのまま返すためです。プロバイダーが返したモデルを確認する必要がある場合は、ネイティブ Gemini 形式を使用してください。

## 推奨ワークフロー

**1. リクエストごとにモデルを検証する**

固定モデル ID では、厳密な比較を使用します: `response.model_version == requested_model`。値が欠落している場合も、実際のモデルを確認できないため例外マーカーが必要です。デフォルトで合格として扱わないでください。

**2. アラートを出し、元の結果を保持する**

返されたテキストや使用量を破棄せずに、異常を記録します。結果は診断に役立つため、モデルの不一致だけで直ちに課金対象の 2 回目のリクエストを作成しないでください。

**3. バッチを停止せずにタスクを分離する**

現在のタスクを `needs_rerun` としてマークし、残りのタスクを続行します。バッチレポートには、少なくとも成功、モデル報告の異常、その他の失敗、2 回目のパスを待機中のタスクをまとめる必要があります。

**4. レビュー後に 2 回目のパスを実行する**

影響を受けたタスク ID のみを含むリストを生成します。2 回目のパスでも返されたすべてのモデルを再度確認し、最初のレポートは変更せず、無制限の自動リトライは避けてください。

## Python 検証例

この例では `google-genai` SDK を使用します。リクエストは 1 回だけ実行し、判断は呼び出し元のバッチプログラムに委ねます。自動的に再試行することはありません。

```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` または相対業務ファイルパス | 2回目の処理が必要なタスクを特定する |
| `requested_model` | リクエストで送信した正確なモデル ID |
| `model_version` | ネイティブレスポンスで返されたモデル |
| `response_id` | タイムスタンプと併せて特定のリクエストを特定する |
| `needs_rerun` / 例外理由 | バッチ全体を再実行せず、対象を絞った2回目の処理リストを作成する |
| タイムゾーン、レイテンシ、tokens を含むタイムスタンプ | 異常の分布とコストを分析する |
| 元のテキストと `finishReason` | 証跡を保持し、モデルの異常と空のレスポンスまたは途中で切り詰められたレスポンスを区別する |

> [!NOTE]
>
> APIキーは記録しないでください。サポートに連絡する際は、リクエストしたモデル、返されたモデル、`responseId`、タイムゾーン付きのタイムスタンプ、サニタイズした再現用リクエストを提供してください。顧客のコンテンツや業務データセット全体を共有しないでください。

## よくある質問

> [accordion] 不一致を検出した後、すぐに再試行しないのはなぜですか？
>
> 即時再試行はトラフィックとコストを増加させ、異常が続いている間に再試行の集中を引き起こす可能性があります。初回の証拠を保持し、制限された2回目の処理を行う前に影響を受けたタスクを分離することで、診断と計上が容易になります。ビジネス上、自動再試行が必要な場合は、最大試行回数、バックオフ、サーキットブレーカーを設定し、すべてのレスポンスを記録してください。

> [accordion] 不一致の値は、Flash-Lite が回答を生成したことの証明になりますか？
>
> このフィールドだけから結論を導くことはできません。原因は、実際のルーティング変更である可能性もあれば、バージョンまたはメータリングメタデータの異常である可能性もあります。いずれの場合も、特定のモデルを必須とするタスクでは、その結果をモデル整合性検証の失敗として扱う必要があります。

> [accordion] すべてのモデル名を厳密に比較すべきですか？
>
> ここで対象とする固定の Gemini 4 モデル ID には、完全一致が最も明確なルールです。`latest` のようなエイリアスを意図的に使用している場合、具体的なバージョンが返されるのは正常な場合があります。固定 ID ルールを適用するのではなく、明示的に許可したバージョンのセットに対して検証してください。

> [accordion] 2回目の処理でも別のモデルが返された場合はどうすればよいですか？
>
> それ以上の自動再試行を停止し、両方のレポートを保持してください。影響を受けた `responseId` の値、要求したモデルと返されたモデル、タイムスタンプ、およびサニタイズ済みの再現リクエストを収集し、プロバイダー側の状況を調査するため APIYI サポートに連絡してください。

## 関連ドキュメント

> [card] [Gemini ネイティブレスポンス解析](https://docs.apiyi.com/ja/api-capabilities/gemini/response-handling.md)
>
> 非ストリーミング、ストリーミング、modelVersion、responseId、usage フィールド

> [card] [Gemini ネイティブ API ガイド](https://docs.apiyi.com/ja/api-capabilities/gemini/native.md)
>
> google-genai SDK、ネイティブエンドポイント、推論設定

> [card] [Gemini 4 Carbon モデル切り替えに関する注意事項](https://docs.apiyi.com/ja/api-capabilities/gemini-4-carbon/overview.md)
>
> これまでに確認された動作、影響、推奨事項

> [card] [Gemini 4 Argon テキスト生成](https://docs.apiyi.com/ja/api-capabilities/gemini-4-argon/overview.md)
>
> Argon のモデル ID、デュアルエンドポイント、呼び出し例


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