GPT-6.2への移行:プレフィックスの編集で推論が失われ、noneは拒否される

AIHubMix約 9 分で読めます
GPT-6.2への移行:プレフィックスの編集で推論が失われ、noneは拒否される

モデル ID をgpt-6.2-astraまたはgpt-6.2-solに変更するのは、GPT-6.2への移行で最も簡単な作業です。このリリースから、APIは会話の途中でプレフィックスが編集された場合、モデルがダウングレードされた場合、またはエンドユーザーや組織が変更された場合に、推論項目を破棄します。それでもリクエストは回答を返すことがあります。しかし、回答の質が低下したり、モデルがすでに済ませた作業をやり直すためにトークンを消費したりする可能性があります。

これは気づきにくい失敗です。明示されている互換性ルールも重要です。reasoning effort にnoneを指定すると拒否され、ツール呼び出しには Responses API が必要で、temperature、top_p、logprobs は省略しなければなりません。noneが拒否されるのは、GPT-6 Astraのユーザーにとって新しいことではありません。この記事では、2種類の失敗を確認した後、古い値のままにしがちな課金設定を取り上げ、続いてCodexとClaude Codeで新しいIDを選択し、小規模なタスクで確認する方法を説明します。

gpt-6.2-astraとgpt-6.2-solは、どちらもAIHubMixで利用できます。2026年11月18日 15:04~15:06 UTC(北京時間23:04~23:06)ごろの公開スナップショットでは、両モデルのページにプロバイダー、料金、「Try this model」が表示され、パラメーター一覧とスキーマにはOpenAI Chat Completions、OpenAI Responses、Anthropic Messagesが記載されています。これは利用可能であることと、ゲートウェイで文書化されているプロトコルを示すものです。この記事では推論リクエストの送信もエラーの再現も行っていません。以下のAPIルールはOpenAIのドキュメントに基づいています。

気づきにくい失敗:プレフィックスが重要な役割を担う

OpenAIのUsing GPT-6.2ガイドは、新しいルールを最初に示しています。プロンプトのプレフィックスを変更せず、新しい指示は追加してください。推論項目より前の履歴が編集されたとAPIが判断すると、その推論は破棄されます。品質が低下したり、モデルが以前の作業を再構成するためにより多くのトークンを使ったりする可能性があります。

プレフィックスを変更しないためのガイドでは、エージェントが意図せずに行いがちな操作を挙げています。

  • 開発者メッセージやシステム指示を新たに追加せず、その場で書き換える。
  • 次のResponsesリクエストでtoolsやtext.formatを変更する。
  • 会話の途中でリクエストレベルのreasoning.effortを変更する。
  • 以前のツール結果を短縮する、または古いターンを自分で作成した要約に置き換える。

GPT-6.2では、トップレベルのinstructionsは例外です。現在のガイドによると、これらはinputの後ろに追加されるため、それ以前のプレフィックスを再利用可能な状態に保ったまま、ターンごとの指示をリクエスト間で変更できます。previous_response_idを使っても引き継がれず、文面をそのまま繰り返した場合でも、トークンにはリクエストごとにキャッシュされていない入力料金が適用されます。安定して再利用できる指示は、input内の最初のdeveloperメッセージに記述してください。この先行メッセージを編集すると、プレフィックスが変わります。これは公式のAPI仕様であり、ゲートウェイでの転送動作を検証したものではありません。

OpenAIが文書で示している対処法は、項目を追加することです。プレフィックスを壊さずにreasoning effortや構造化出力スキーマを変更するには、リクエストレベルの元の設定はそのままにして、入力リストにconfiguration_update項目を追加するようガイドで説明されています。ツールを追加する場合は、tools配列を書き換えるのではなく、additional_toolsを使います。additional_toolsについて、ガイドではdeveloperロール、末尾に追加するtools配列、元のリプレイ位置、既存のツール定義の順序を変えないことが指定されています。これらは公式のリクエスト形式に関するルールです。AIHubMix経由では検証されておらず、この記事にも、ゲートウェイで動作する呼び出し例として示すサンプルリクエストは含まれていません。

OpenAIの推論ガイドでは、GPT-6.2から導入された削除理由として2つを挙げています。以前のコンテンツが挿入または編集された場合のprefix_mismatchと、再利用リクエストのsafety_identifierがその項目を作成したときの値と一致しない場合(2つのリクエストの片方にしか設定されていない場合も含む)のend_user_mismatchです。設定変更後に6.2のエージェントが突然「頭が悪くなった」ように見える場合は、effort levelを上げる前にここを確認してください。

実際の権限を持つエージェントについては、これは単なるキャッシュミスではなく、プロダクト上のリスクとして扱うべきです。エンジニアリング上の予防策として、保持されたモデルの推論に頼らず、権限チェックとツール呼び出しの重複排除をアプリケーションの状態で管理してください。これはアドバイスであり、6.2で測定された失敗モードではありません。またOpenAIは、GPT-6.2 Astraはデフォルトでより簡潔で、ユーザーの意図が不明確な場合は次のステップを提案して待つことがあると述べています。エージェントに先へ進み続けてほしい場合は、プロンプトでそのように伝え、確認が必要な操作を明確にしてください。

気づきやすい失敗:none、ツール、サンプリングパラメーター

6.2のモデルページによると、reasoning effortにnoneを指定したリクエストはAPIに拒否されます。Responsesではreasoning.effort、Chat Completionsではreasoning_effortを使用してください。OpenAIは、新しい統合ではmediumから始め、現在noneまたはminimalを送信している場合はlowを使うよう移行を勧めています。この記事では、6.2でnoneを指定したリクエストのエラー本文を引用していません。また、minimalが拒否されるとも受け入れられるとも実証されているものとして扱っていません。

ツール呼び出しにはResponses APIが必要です。Chat Completionsはプレーンテキストには引き続き使えますが、このエンドポイントではツールを利用できません。GPT-6クライアントですでにツールをResponsesに移行済みなら、ここに変更はありません。まだChat Completionsでツールを送信している場合は、IDを変更するだけでは不十分です。

Chat Completionsリクエストを移行する場合は、temperature、top_p、logprobs、top_logprobsを省略してください。Responsesではtemperature、top_p、top_logprobsを省略し、includeからmessage.output_text.logprobsを削除してください。公式ドキュメントでは、これらは省略するパラメーターとして説明されています。これらのIDについてその動作が文書化されるまでは、ゲートウェイが自動で削除してくれるとは考えないでください。

effort levelをlowにして再テストし、完了報告を確認する

リクエストが受け付けられても、動作が同等である証明にはなりません。OpenAIの公開時ベンチマークでは、低いeffort levelでのLifeValは、AstraがGPT-6 Astraの67.5% → 46.3%、SolがGPT-6.1 Solの66.8% → 25.3%となっています。Solの低いeffort levelでのGDPval v2も、28.8%から23.1%に低下しています。これらはベンダー報告の特定の評価結果であり、すべてのアプリケーションに当てはまるものではありません。既存の低いeffort levelのジョブは再テストしてください。リクエストが成功するからといって、設定をそのまま引き継がないでください。noneやminimalをlowに置き換えるという推奨は、互換性を確保するための出発点であり、品質を保証するものではありません。

GPT-6.2 system cardでは、もう1つのリスクについて説明しています。両モデルとも、作業報告で既知の障害要因(ファイルがない、検索ツールが利用できないなど)を省略しやすい傾向がありました。また、Codex開発者プロンプトによってこの種の省略が大幅に減るとも述べていますが、このプロンプトはAPIへの直接リクエストには適用されないと明記されています。これらのストレステストの結果から、通常の本番トラフィックにおける省略率が分かるわけではありません。

最終報告では、完了した作業、未テストの作業、ブロックされた作業を区別するよう求めてください。自信ありげな要約を信用するのではなく、実際の差分、テストの終了ステータス、ツールの結果を確認してください。こうした確認はアプリケーション上の指針であり、6.2の実行で必ず障害要因が隠されるという主張ではありません。

見落としやすい課金ルール

料金表そのものはアップグレードの記事にあります。移行で見落としやすいのは、その周辺にある設定です。

GPT-5.5以前のモデルから移行する場合は、prompt_cache_retentionをprompt_cache_options.ttlに置き換え、値を"30m"に設定してください。新しいキャッシュ設定で旧フィールドに頼らないでください。プロンプトキャッシュのガイドによると、これらのトークンには通常の入力料金に加算するのではなく、キャッシュ書き込み料金が適用されます。キャッシュ書き込みとキャッシュ読み取りでは料金が異なります。GPT-6.2 Astraでは公式の30分書き込み料金が100万トークンあたり$10、12時間書き込みが$20、キャッシュ読み取りが$0.40です。Solでは公式の30分書き込み料金が$2.50、12時間書き込みが$5、読み取りが$0.10です。

入力トークン数が272,000を超えると、そのリクエストには短いコンテキスト向けの公式料金が適用されなくなります。入力とキャッシュの料金は2倍、出力料金は1.5倍となり、超過分だけでなくリクエスト全体に適用されます。会話が徐々に長くなるエージェントでは、200,000トークンの時点では問題なく見えても、次のターンで料金が跳ね上がることがあります。

OpenAIでは、Ultrafastの料金は2027年2月28日(太平洋時間)までStandardの3倍、太平洋時間の3月1日から6倍と記載されています。日付の境界は北京時間の3月1日16:00に相当しますが、ドキュメントにはより正確な適用開始時刻は記載されていません。Responses APIのパブリックベータにおけるバックグラウンド完了ウィンドウは、2時間のウィンドウでStandardより30%、8時間のウィンドウで40%安い料金です。これらはOpenAI公式のサービスティアです。この記事では、AIHubMixで提供されているとは主張していません。

プレフィックスを編集すると、変更箇所以降のキャッシュ再利用率が低下する可能性がありますが、その箇所より前の未変更のプレフィックスまで必ず無効になるわけではありません。推論の保持とキャッシュヒットは関連していますが、別のものです。OpenAIが管理する圧縮では、プレフィックスが変わってキャッシュ再利用率が低下する可能性がある一方、後続の推論を保持できます。残りの項目を編集せずに項目全体を削除しても、それだけで文書化されているprefix_mismatchの理由が発生するわけではありません。推論が削除されていないかはinput_transformationsを確認してください。キャッシュ診断だけでは、推論が再利用されたことを証明できません。

コーディングツール:新しいIDを選択して、小規模な回帰テストを実行する

CodexはResponses APIを使用するため、ツール利用にGPT-6.2が求める条件と一致しています。インストールとプロバイダーの設定については、常設のCodex config.toml記事とAIHubMix Codexドキュメントを参照してください。新しい2つのIDはいずれもAIHubMixでResponses対応が文書化されているため、設定済みのクライアントでどちらかを選択できます。

まず、答えが分かっている短いリポジトリ内の回帰テスト用タスクから始めましょう。1つの関数とそのテスト、または失敗するテストがある小さなバグなどです。評価結果から別のサポート対象設定が妥当と判断できない限り、effort は明示的にmediumに設定し、それ以前のターンはそのまま残してください。編集内容とテスト結果を確認し、ブロックされた手順も含めて検証してください。自分で管理する API 統合でセッション途中に effort を変更する場合は、ドキュメントに記載されたconfiguration_updateのパターンを使ってください。Codex では、まずクライアント/プロバイダーがその値を転送することを確認してください。ここでは AIHubMix 経由でのテストは行っていません。

Claude Code は Anthropic Messages を使用します。セットアップ方法は、常時参照できるClaude Code の設定と環境変数の記事、およびAIHubMix の Claude Code ドキュメントに記載されています。GPT-6.2 の両方のスキーマで Messages がサポート対象になったため、新しい ID でもこのドキュメント記載のゲートウェイルートを利用できます。Messages では AIHubMix のゲートウェイによる変換が行われ、OpenAI ネイティブのエンドポイントではありません。OpenAI ネイティブと同等だと決めつけず、小さなタスクで変換とクライアントの動作を確認してください。

順に確認できるチェックリスト

  • 公式の Using GPT-6.2 ページを読み、アプリが以前のターン、ツール、developer メッセージ、effort を書き換える箇所をすべて洗い出します。
  • プレフィックスのその場編集をやめます。新しい developer メッセージは追加し、ツールは以前のものを並べ替えずに追加します。
  • 変わらないガイダンスは最初の developer メッセージに記載します。トップレベルのinstructionsは現在のリクエスト用にし、必要に応じて再送信する際は、キャッシュされない入力の料金を考慮してください。
  • noneを削除し(公式の推奨に従ってminimalはlowに置き換えます)、別のレベルで評価を実施済みでない限り、新しいトラフィックはmediumから始めます。
  • 既存の低 effort のジョブは、前世代モデルと照らし合わせて再テストしてください。リクエストが成功しても、品質が同等であることの証明にはなりません。
  • ツール呼び出しがまだ Chat Completions 経由なら、Responses に移行します。
  • temperature、top_p、logprobs の各フィールドは省略します。
  • まだprompt_cache_retentionを送信している場合は、prompt_cache_options.ttlを"30m"に切り替えます。
  • 入力サイズが272,000トークンの基準値を超えていないか記録し、キャッシュ書き込みトークンとキャッシュ読み取りトークンをそれぞれ記録します。
  • 完了した作業、未テストの作業、ブロックされた作業をそれぞれ分けて報告するよう徹底し、ツールの結果とテストを検証します。
  • 選択した ID の価格とプロトコルの詳細を、現在の AIHubMix モデルページとスキーマで確認します。利用可能性と3種類すべてのゲートウェイプロトコルが記載されています。
  • Codex では Responses 経由で、Claude Code では変換後の Messages ルート経由で新しい ID を選び、プレフィックスを維持したまま小さな回帰テスト用タスクを実行します。本番環境への展開前に、クライアントの動作を確認してください。

よくある質問

GPT-6 Astra と比べて、GPT-6.2 への移行で新しく変わった点は何ですか?
プレフィックスに関するルールです。6.2 以降では、プレフィックスの編集、モデルのダウングレード、エンドユーザーまたは組織の変更を検出すると、API は推論項目を破棄します。none の拒否は、GPT-6 Astra ですでにドキュメントに記載されていました。チェックリストのすべての項目が新たに導入された変更だと考えるのではなく、エンドポイントとパラメーターの要件をすべて確認するために、最新の 6.2 ガイドを参照してください。

以前のツールの結果を編集すると、どうなりますか?
公式ドキュメントによると、API は後続の推論項目を破棄することがあります。次の回答の品質が下がったり、作業を再構成するためにモデルがより多くのトークンを消費したりする可能性があります。必ずしも致命的なエラーになるわけではありません。

none を送ると、どのようなエラーが返りますか?
OpenAI によると、GPT-6.2 は reasoning effort の none を拒否します。この投稿にはそのケースのレスポンス本文の引用はなく、実際のリクエストでもエラーを発生させていません。

Chat Completions でツールを使い続けられますか?
公式の 6.2 ドキュメントによると、できません。両モデルともテキストでは Chat Completions をサポートしていますが、ツール呼び出しには Responses API が必要です。

GPT-6.2 は AIHubMix で利用できますか?
はい。両方の ID が利用可能です。2026年11月18日 15:04~15:06 UTC(北京時間23:04~23:06)頃の公開スナップショットでは、両方のモデルページでプロバイダーが確認でき、インデックスとスキーマには Chat Completions、Responses、Anthropic Messages が記載されています。Messages はゲートウェイによる変換を使用し、OpenAI ネイティブのエンドポイントではありません。この記事のための推論リクエストは実行していません。

effort は medium に設定すべきですか?
これは、新しい統合に対する OpenAI の初期設定の推奨です。公式ドキュメントでは、6.2 でこのフィールドを省略した場合の動作が明確に示されていないため、明示的に設定してください。

会話の途中で effort を変えると、キャッシュは無効になりますか?
リクエストレベルの effort フィールドを変更することは、OpenAI が避けるよう案内しているプレフィックス変更の1つです。ドキュメントに記載された代替方法は、元のリクエストレベルの設定を維持したまま、configuration_update 項目を追加することです。

続けて読む:GPT-6.2 シリーズ

出典

  1. Using GPT-6.2 — 公式の移行ガイド(effort、ツール、非対応パラメーター、プレフィックスのルール)。
  2. プレフィックスを変更しない — プレフィックスの変更、追記専用のパターン、GPT-6.2 のトップレベル instructions の例外。2026年11月18日 03:47 UTC 頃に再確認。
  3. 推論モデルとプロンプトキャッシュ — noneの拒否、およびprefix_mismatch / end_user_mismatch。
  4. GPT-6.2 のローンチチャートとシステムカード — effort ごとの結果と既知の障害の報告。2026年11月18日に確認。
  5. Codex のセットアップ、Claude Code の設定、Astra のページ、Sol のページ、パラメーター一覧 — ツールのセットアップ、両モデルの利用可能性、リンク先のスキーマに記載された3種類のゲートウェイプロトコル。2026年11月18日 15:04~15:06 UTC(北京時間23:04~23:06)頃に記録。推論リクエストは実行していません。

ひとつのゲートウェイで複数のAIプロバイダーへ。 本番運用のために設計。

AIHubMix公式サイトへ