メインコンテンツへスキップ

簡単な回答

gemini-4-argonやgemini-4-hydrogenなどのGemini 4モデルを呼び出す際、ネイティブレスポンス内のmodelVersionがリクエストしたモデルと異なる場合、HTTP 200が返されたという理由だけでタスクを成功として扱わず、自動的にすぐ再試行しないでください。 レスポンスを保持し、リクエストしたモデル、返されたモデル、responseId、および業務タスクIDを記録してください。タスクをneeds_rerunとしてマークします。バッチ完了後に例外レポートを作成し、それらのタスクのみを対象に2回目の処理を実行するかどうかを判断してください。
これは、Googleのプロバイダー側で発生する可能性があるモデル報告またはルーティングの異常です。リクエストがポリシーに違反したことや、アカウントのグレードが下げられたことを意味するものではありません。 modelVersionだけでは、異なるサービングウェイトによって回答が生成されたことを証明できませんが、一貫性が重要なタスクでは、その結果をリクエストしたモデルからの有効な出力として受け入れないでください。

条件の確認方法

ネイティブ Gemini generateContent レスポンスには、トップレベルに modelVersion と responseId の両方が含まれます。
リクエストが 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 回だけ実行し、判断は呼び出し元のバッチプログラムに委ねます。自動的に再試行することはありません。
ストリーミング呼び出しでは、最後の値だけを保持するのではなく、各チャンクでモデルから報告された値を収集します。
集合が空の場合、別のモデルを含む場合、または複数のモデルを含む場合、needs_rerun は True です。テキストをチャンクごとに組み立て続け、finishReason と使用量を個別に確認してください。

バッチレポートに記録する内容

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

よくある質問

即時再試行はトラフィックとコストを増加させ、異常が続いている間に再試行の集中を引き起こす可能性があります。初回の証拠を保持し、制限された2回目の処理を行う前に影響を受けたタスクを分離することで、診断と計上が容易になります。ビジネス上、自動再試行が必要な場合は、最大試行回数、バックオフ、サーキットブレーカーを設定し、すべてのレスポンスを記録してください。
このフィールドだけから結論を導くことはできません。原因は、実際のルーティング変更である可能性もあれば、バージョンまたはメータリングメタデータの異常である可能性もあります。いずれの場合も、特定のモデルを必須とするタスクでは、その結果をモデル整合性検証の失敗として扱う必要があります。
ここで対象とする固定の Gemini 4 モデル ID には、完全一致が最も明確なルールです。latest のようなエイリアスを意図的に使用している場合、具体的なバージョンが返されるのは正常な場合があります。固定 ID ルールを適用するのではなく、明示的に許可したバージョンのセットに対して検証してください。
それ以上の自動再試行を停止し、両方のレポートを保持してください。影響を受けた responseId の値、要求したモデルと返されたモデル、タイムスタンプ、およびサニタイズ済みの再現リクエストを収集し、プロバイダー側の状況を調査するため APIYI サポートに連絡してください。

関連ドキュメント

Gemini ネイティブレスポンス解析

非ストリーミング、ストリーミング、modelVersion、responseId、usage フィールド

Gemini ネイティブ API ガイド

google-genai SDK、ネイティブエンドポイント、推論設定

Gemini 4 Carbon モデル切り替えに関する注意事項

これまでに確認された動作、影響、推奨事項

Gemini 4 Argon テキスト生成

Argon のモデル ID、デュアルエンドポイント、呼び出し例