簡単な回答
gemini-4-argonやgemini-4-hydrogenなどのGemini 4モデルを呼び出す際、ネイティブレスポンス内のmodelVersionがリクエストしたモデルと異なる場合、HTTP 200が返されたという理由だけでタスクを成功として扱わず、自動的にすぐ再試行しないでください。
レスポンスを保持し、リクエストしたモデル、返されたモデル、responseId、および業務タスクIDを記録してください。タスクをneeds_rerunとしてマークします。バッチ完了後に例外レポートを作成し、それらのタスクのみを対象に2回目の処理を実行するかどうかを判断してください。
条件の確認方法
ネイティブ GeminigenerateContent レスポンスには、トップレベルに 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回目の処理を行う前に影響を受けたタスクを分離することで、診断と計上が容易になります。ビジネス上、自動再試行が必要な場合は、最大試行回数、バックオフ、サーキットブレーカーを設定し、すべてのレスポンスを記録してください。
不一致の値は、Flash-Lite が回答を生成したことの証明になりますか?
不一致の値は、Flash-Lite が回答を生成したことの証明になりますか?
このフィールドだけから結論を導くことはできません。原因は、実際のルーティング変更である可能性もあれば、バージョンまたはメータリングメタデータの異常である可能性もあります。いずれの場合も、特定のモデルを必須とするタスクでは、その結果をモデル整合性検証の失敗として扱う必要があります。
すべてのモデル名を厳密に比較すべきですか?
すべてのモデル名を厳密に比較すべきですか?
ここで対象とする固定の Gemini 4 モデル ID には、完全一致が最も明確なルールです。
latest のようなエイリアスを意図的に使用している場合、具体的なバージョンが返されるのは正常な場合があります。固定 ID ルールを適用するのではなく、明示的に許可したバージョンのセットに対して検証してください。2回目の処理でも別のモデルが返された場合はどうすればよいですか?
2回目の処理でも別のモデルが返された場合はどうすればよいですか?
それ以上の自動再試行を停止し、両方のレポートを保持してください。影響を受けた
responseId の値、要求したモデルと返されたモデル、タイムスタンプ、およびサニタイズ済みの再現リクエストを収集し、プロバイダー側の状況を調査するため APIYI サポートに連絡してください。関連ドキュメント
Gemini ネイティブレスポンス解析
非ストリーミング、ストリーミング、modelVersion、responseId、usage フィールド
Gemini ネイティブ API ガイド
google-genai SDK、ネイティブエンドポイント、推論設定
Gemini 4 Carbon モデル切り替えに関する注意事項
これまでに確認された動作、影響、推奨事項
Gemini 4 Argon テキスト生成
Argon のモデル ID、デュアルエンドポイント、呼び出し例