イメージブリッジ

概要

OpenAI 以外のモデル (Claude、Gemini、Grok など) を介して Codex をルーティングする場合、image_generation ホストツール は通常機能しません。OpenAI のサーバー側実行環境が必要です。 Image Bridge はこれらの呼び出しを検出し、それらを xAI Grok Imagine に透過的に再ルーティングするため、実際にチャットしているモデルは引き続きイメージを生成できます。

前提条件

設定で images.bridgeEnabled: true を設定してブリッジを有効にします (これはオフになっています) 予期しない xAI 請求を避けるためのデフォルト — 以下の構成を参照してください)。
API キーを持つ xai プロバイダーエントリ。ブリッジはフルフィルメントをレジストリ xAI に固定します画像エンドポイント (https://api.x.ai/v1);設定された baseUrl オーバーライドは、イメージ呼び出しでは無視されます。 OAuth / ocx login xai だけではブリッジを準備しません** (Grok CLI OAuth トランスポートはチャット指向であり、/images/* には使用されません)。

「json { "providers": { "xai": { "adapter": "openai-chat", "apiKey": "xai-…", "authMode": "key" } } } 」

アクティブなプロバイダーとして選択された非 OpenAI モデル。 (アクティブプロバイダーが OpenAI の場合、ネイティブでホストされているツールが直接使用され、ブリッジはバイパスされます。)

構成

Image Bridge オプションは、~/.opencodex/config.json の images の下にあります。ブリッジングはオプトインです。有料の xAI Grok Imagine 生成を有効にするには、bridgeEnabled: true を設定する必要があります。

{
  "images": {
    "bridgeEnabled": true,
    "bridgeModel": "grok-imagine-image-quality",
    "maxRounds": 3,
    "timeoutMs": 60000
  }
}

オプション	デフォルト	説明
`bridgeEnabled`	`false`	マスタースイッチ。 `true` を設定してブリッジを有効にします。予期せぬ xAI 請求を避けるため、デフォルトではオフになっています。
`bridgeModel`	`grok-imagine-image-quality`	プロンプトの送信先となる xAI イメージモデル ID。
`maxRounds`	`3`	ターンごとのイメージ生成ループの最大反復数。整数に下限され、`[0, 10]` に固定されます。非有限値は `3` にフォールバックします。
`timeoutMs`	`60000`	呼び出しごとの xAI 期限 (ミリ秒単位)。有限の正の値は下限処理され、xAI リクエストに渡されます。
`artifactsKeepCount`	`200`	`artifacts/` で保持されるファイルの最大数。これを超えると、呼び出しが完了するたびに最も古いファイルが削除されます。枝刈りを無効にするには、`0` または負の値に設定します。

アーティファクトの保持

生成されたイメージは~/.opencodex/artifacts/に書き込まれます。長時間実行セッションで際限なくディスクが増大するのを防ぐため、イメージ呼び出しが実行されるたびに (その呼び出しの完全なバッチがディスク上にあると) ディレクトリは自動的にプルーニングされます。カウントが構成された最大値 (デフォルトは 200、images.artifactsKeepCount で構成可能) を超えると、(変更時間による) 最も古いファイルが削除されます。枝刈りを生き残ったパスのみがモデルに返されます。

仕組み

Image Bridge は、非 OpenAI モデルが選択されているときに、/v1/responses ツール配列にホストされた image_generation ツールを含む レスポンス ターンでのみアクティブになります。これは、/v1/images/generations (または /images/edits) に直接 POST する Codex の組み込み image_gen ツールをインターセプトしません**。そのパスについては Codexの統合で別途説明します。

応答リクエストで tools に image_generation がリストされると、OpenCodex がそれを検出しますリクエストの前処理中。
ホストされたツールは、ルーティングされたモデルが呼び出すことができる 合成関数ツール に置き換えられます。通常 — モデルは、実行できない不透明なホストされたツールではなく、呼び出し可能なツールを認識します。
モデルがそのツールを呼び出すと、OpenCodex が呼び出しを傍受し、プロンプトを xAI のサーバーに送信します。画像生成API。
生成されたイメージは ~/.opencodex/artifacts/ に保存され、ローカルファイルパスが返されます。ツールの結果としてモデルに適用されます。
モデルは、生成された画像とその位置を認識して会話を続けます。

モデルの観点からは何も変わりません。モデルはツールを呼び出して結果を取得しました。ユーザーの観点から見ると、イメージ生成は、サイレントに失敗するのではなく、ルーティングされたプロバイダーで動作します。

制限事項

xAI Grok Imagine のみがサポートされています。 DALL-E および他のイメージプロバイダーは後で追加される可能性があります。
Web 検索は、Web 検索サイドカーループをサポートするアダプターで優先されます。両方のウェブの場合検索と画像生成が同じ順番で要求されると、Web 検索が実行され、画像生成はスキップされます。現在、カーソル/runTurn アダプターはそのサイドカーを使用できないため、イメージブリッジはデュアルツールターンでも実行される可能性があります。
xAI の費用が適用されます。 xAI による画像生成には、有効な xAI サブスクリプションまたは API クレジットが必要です。
ストリーミングのみ。 ブリッジは SSE 応答ストリームをインターセプトすることで機能します。とのリクエスト stream: false は 400 エラーで拒否されます。