ルーティング構成

ルーティングは、クライアントから送信されたモデル ID を 1 つの具体的なプロバイダーと上流モデルに変換します。

トップレベルのルーティングフィールド

フィールド	タイプ	デフォルト	意味
`defaultProvider`	`string`	`"openai"`	以前のモデルのルールが一致しない場合に使用される最終プロバイダー。有効な構成済みプロバイダーを指定する必要があります。
`combos?`	`Record<string, OcxComboConfig>`	`{}`	注文されたプロバイダー/モデルターゲットから構築された仮想 `combo/<id>` モデル。

モデルの解決順序

opencodex は、要求されたモデルを次の順序で解決します。

正規の combo/<id> または構成されたコンボエイリアス。正規 ID は、エイリアスが一致する前に優先されます。
構成されたプロバイダーを示すプレフィックスを持つ明示的な <provider>/<model> 名前空間。
gpt-*、o1-*、o3-*、o4-* などのベアネイティブ OpenAI ファミリ ID。正規対応の openai プロバイダー。
プロバイダーの defaultModel と完全に一致します。
既知のプロバイダーファミリモデルプレフィックス。
プロバイダーの構成された models リスト内の正確なモデル。
defaultProvider、要求されたモデル ID を保持します。

無効なプロバイダーは除外されます。無効なプロバイダーの明示的な名前空間は、フォールスルーではなく失敗します。プロバイダーエントリは、複数のプロバイダーに一致する可能性のあるルールの JSON 挿入順序でチェックされるため、ベアモデルがあいまいな可能性がある場合は明示的な名前空間を使用します。

コンボ (`config.combos`)

各コンボキーは [A-Za-z0-9][A-Za-z0-9._-]{0,63} に一致する ID です。これは常に combo/<id> として直接アドレス指定可能であり、1 つの alias を公開することもあります。エイリアスは一意である必要があり、combo/ 名前空間を占有することはできず、gpt-*、o1-*、o3-*、o4-*、または codex-* などの予約されたベアネイティブファミリを使用することはできません。

キー	タイプ	デフォルト	意味
`targets`	`{ provider: string; model: string; weight?: number }[]`	必須	具体的なルートを指示しました。 `weight` は 1 ～ 10000 で、デフォルトは `1` です。
`strategy?`	`"failover" \| "round-robin"`	`"failover"`	選択戦略。ターゲットの順序はフェイルオーバーの優先順位です。重みはスムーズな重み付きラウンドロビンを形成します。
`stickyLimit?`	`number`	`1`	成功したリクエストは 1 つのラウンドロビンバッチに保持されます。範囲は 1 ～ 100。
`defaultEffort?`	`"low" \| "medium" \| "high" \| "xhigh" \| "max" \| "ultra" \| null`	設定を解除する	呼び出し元が努力を省略し、選択されたターゲットが要求されたラングをアドバタイズする場合にのみ適用されます。
`alias?`	`string`	—	正規のピッカースラグの代わりのオプションのパブリックモデル ID。

{
  "defaultProvider": "openai",
  "combos": {
    "coding": {
      "targets": [
        { "provider": "anthropic", "model": "claude-sonnet-5" },
        { "provider": "openrouter", "model": "qwen/qwen3-coder-plus" }
      ],
      "strategy": "failover",
      "defaultEffort": "high",
      "alias": "coding-primary"
    }
  }
}

戦略の動作、再試行可能な失敗、クールダウン、暗号化された v2 タスクの制限、および管理コマンドについては、コンボを参照してください。

カタログの適格性

コンボは、リストに表示できない場合でも、直接ルーティング可能です。 ocx sync、/v1/models、および Codex ピッカーは、すべてのターゲットが交差できる機能を公開している場合にのみリストします。

ライブメタデータ、レジストリヒント、またはプロバイダーからの正の contextWindow modelContextWindows / contextWindow;そして
空ではない inputModalities 交差。省略されたメンバー値を ["text"] として扱います。

コンテキストメタデータのない裸のリレー ID、または接続されていないモダリティを持つターゲットは、カタログからコンボを削除します。同期によって概要の警告が表示され、ダッシュボードで 注意が必要 とマークされます。コンテキストメタデータを追加し、モダリティを調整したり、検出可能な互換性のある機能を備えたターゲットモデルを追加したりできます。

ルーティング構成

トップレベルのルーティングフィールド

モデルの解決順序

コンボ (config.combos)

カタログの適格性

コンボ (`config.combos`)