ビデオブリッジ

概要

Video Bridge を使用すると、opencodex によってルーティングされる非 OpenAI モデルを通じて xAI の Grok Imagine Video 生成を使用できます。有効にすると、合成 video_gen ツールが会話に挿入されます。モデルはこれを他の関数ツールと同様に呼び出します。 opencodex は通話をインターセプトし、ビデオ生成ジョブを xAI に送信し、完了するまでポーリングして、結果をダウンロードします。

前提条件

API キーを持つ xai プロバイダーエントリ (ocx login xai だけでは十分ではありません。ビデオブリッジには OAuth ではなくキー認証が必要です)
ルーティングプロバイダーとしての非 OpenAI モデル (例: Anthropic Claude、Google Gemini)
opencodex は非 OpenAI プロバイダーを介してルーティングするように構成されています

⚠ プロバイダーキーが必要です: ビデオブリッジは、xai プロバイダーが使用する場合にのみアクティブになります。 APIキー認証。これを設定に追加します。
{
  「プロバイダー」: {
    "xai": { "adapter": "openai-chat", "apiKey": "xai-…", "authMode": "key" }
  }
}
ocx login xai (OAuth) 経由でオンボードした場合、プロバイダーは authMode: "oauth" のままになります。ブリッジは静かに起動しません。 または環境でXAI_API_KEYを設定します上に示したようにキーをハードコーディングします。

構成

videoBridgeEnabled: true を images 設定に追加します。

{
  "images": {
    "bridgeEnabled": true,
    "videoBridgeEnabled": true,
    "videoBridgeModel": "grok-imagine-video",
    "videoMaxRounds": 2,
    "videoTimeoutMs": 300000
  }
}

オプション	デフォルト	説明
`videoBridgeEnabled`	`false`	マスタースイッチ。明示的に有効にする必要があります。
`videoBridgeModel`	`"grok-imagine-video"`	xAI ビデオモデル ID。
`videoMaxRounds`	`2`	最終回答を強制するまでの最大ビデオ生成ラウンド数。
`videoTimeoutMs`	`300000` (5 分)	ポーリングを含むビデオごとのタイムアウト。

仕組み

opencodex は、videoBridgeEnabled: true を使用して非 OpenAI ルーティングモデルを検出します
合成 video_gen 関数ツールが会話に挿入されます
モデルが video_gen を呼び出すと、opencodex が xAI の /videos/generations にジョブを送信します。
ブリッジは 5 ～ 15 秒ごとにジョブステータスをポーリングし、ストリームを維持するためにハートビートメッセージを送信します。
ビデオの準備ができたら、アーティファクトディレクトリにダウンロードされます
ローカルファイルパスがツールの結果としてモデルに返されます。

サポートされているパラメータ

video_gen ツールは以下を受け入れます。

パラメータ	タイプ	範囲	説明
`prompt`	文字列	必須	詳細なビデオ生成プロンプト
`duration`	整数	1-15	動画の長さ (秒)
`resolution`	文字列	`"480p"`、`"720p"`	ビデオ解像度
`aspect_ratio`	文字列	7つの比率	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`3:2`、`2:3`

制限事項

xAI のみ: ビデオ生成は、xAI の Grok Imagine Video API を通じてのみ利用できます。
非同期: ビデオの生成には 30 ～ 120 秒かかります
コスト: ビデオ生成は有料の xAI 機能です (480p で ~$0.05/秒、720p で ~$0.07/秒)
呼び出しごとに 1 つのビデオ: video_gen 呼び出しごとに 1 つのビデオが生成されます
イメージブリッジと共存: 両方のブリッジを同時に有効にすることができます
Web 検索の優先度: Web 検索サイドカーがターン中アクティブになっている場合 (runTurn アダプター以外)、ビデオブリッジはスキップされます。この 2 つは同時に実行できません。 console.warn が出力されるため、これをログで検出できます。
タイムアウトは送信 + ポーリングをカバーします: videoTimeoutMs 予算はジョブの送信前に開始されるため、送信呼び出し (60 秒) とその後のポーリングは同じ期限を共有します。