モデルカタログ
ネイティブモデル ID を取得し、一覧への表示とルーティング権限を管理します。
モデル リストが空の場合、または利用可能なモデルを制御する必要がある場合にこれを使用します。プールに表示されているモデルで十分です あなたの最初のリクエスト.
SubLane は、サブスクリプション アカウントごとのモデル ID を検出し、有効なアカウントから各プールのカタログを取得します。プールのホワイトリストは管理者所有のポリシーのままです。発見がそれらに取って代わることは決してありません。報告されたモデルは、残りのクォータや成功した生成テストではなく、アップストリーム サポートを記述します。
合成モデル ID を含むモデル カタログの例:

同期と保存
アカウントのインポート、OAuth の完了、および再認証は、資格情報が保存された後に検出を開始します。再認証により、送信されたトークンが変更されていない場合でも、古いカタログがクリアされます。既存のアカウントは、カタログまたはプールが読み取られるとき、または最初のモデル要求の前に遅延検出されます。アカウントを再度有効にすると、保存されたカタログを更新する必要があるかどうかが確認されます。 接続を確認する そして モデルを更新する 同じ検出操作を共有します。
統合スキーマには、各アカウントの制限された JSON モデルのスナップショットとライフサイクル リビジョンが保存されます。スナップショットには、ソートされ、重複が排除されたネイティブ モデル ID、最後に成功した観察時刻、および検出ソース マーカーが含まれます。マーカーには、Codex クライアントのバージョンとアダプターのリビジョンが含まれます。そのコントラクトをアップグレードすると、古いスナップショットまたはマークされていないスナップショットが、古いスナップショットに関係なく更新されます。各アカウントは、最大 128 個の ASCII 文字からなる 512 個のモデル ID に制限されています。上流の指示、マニフェスト、資格情報は保存されません。 null スナップショットはサポートが不明であることを意味します。正常に取得された空のリストは、既知の空のカタログです。
スナップショットは 15 分間保存されます。古い読み取りは保存された値を返し、共有バックグラウンド更新を開始します。アイドル状態の間は、定期的なアップストリーム ポーリングは行われません。ディスカバリ ソース マーカーが変更されると、コールド リクエストもリフレッシュに参加します。失敗したアップグレードの更新では、以前に知られていた機能が保持されている可能性がありますが、古いカタログでは、リストにないモデルがサポートされていないことを証明できません。手動更新には 5 秒間のクールダウンがあります。失敗した更新では、最後に成功したスナップショットが保持され、30 秒間バックオフされます。失敗した観測によってタイムスタンプが変更されることはありません。 24 時間後、古いスナップショットは管理者に表示されたままになりますが、更新されるまではアドバタイズされたルーティング可能なモデルから除外されます。リフレッシュ状態とバックオフはプロセスローカルです。成功したスナップショットは再起動しても残ります。
モデル検出は同時に最大 2 件で、ワークスペース操作容量にも計上されます。容量の既定値は 128(SUBLANE_GATEWAY_CAPACITY)です。同じアカウントと改訂の検出は共有し、プロセスのコンテキストと 45 秒の期限を使用します。ブラウザー切断はその待機だけを取り消します。コールド検出の総予算も 45 秒です。終了時はワーカーを停止してから SQLite を閉じ、新鮮なカタログの読み取りでは上流へ接続しません。
条件付き書き込みは、古い承認、無効化/削除されたアカウント、または以前のライフサイクル リビジョンからの結果を拒否します。 Discovery はランタイム Codex バージョンを 1 回キャプチャします。ネットワーク要求中に置き換えられたバージョンからの結果は破棄され、スナップショットには実際に上流に送信されたバージョンが保持されます。バージョン ポリシーと安定版リリースの自動同期は、 システム設定。プールの許可、メンバーシップ、ポリシー、および永続化されたスナップショットは、プールの結果を公開する前に 1 つの SQLite トランザクションで再度読み取られます。プールから削除されたモデルは、編集前に開始された更新によってリークすることはできません。
プールカタログとルーティング
有効なプール カタログは、プールの正確なモデル ホワイトリストによってフィルタリングされた、使用可能なアカウント スナップショットの重複排除された結合です。無効化されたアカウントと再認証が必要なアカウントは除外されます。クールダウン、同時実行、および残りのサブスクリプション クォータは、実行時の別個の懸念事項として残ります。リストされているモデルは、すぐに利用可能なリクエスト スロットを約束するものではありません。
アカウント、リソースグループ、キーのカタログはプロバイダー接頭辞を付けず、ネイティブなモデル ID を使用します。Codex、Claude、Antigravity、Grok Build、OpenAI 互換 API の適格なリソースがグループのルーティングとフォールバック設定に従って参加します。公開一覧は非表示モデルを除外します。同じ可視 ID は統合され、複数のプロバイダーが可視経路を提供する場合の owned_by は sublane です。思考バリアントの権限は完全な ID、能力は検出済みの基本モデルで判断します。集約上限は 4,096 ID です。従来のプロバイダー接頭辞付きリクエストも使用でき、明示的な接頭辞は候補を限定します。
推論の前に、ディスカバリーはプール内の適格なプロバイダーの欠落しているカタログまたは古いカタログをウォームアップします。明示的なレガシー プレフィックスにより、検出はそのプロバイダーに限定されます。圧縮によりウォームアップされ、Codex アカウントのみが選択されます。スケジューラは、選択トランザクションでプール ポリシーとアカウントのスナップショットを再チェックし、要求されたモデルをサポートしていないアカウントをフィルタリングして除外し、既存の同時実行ルール、クールダウン ルール、およびローテーション ルールを適用します。既知のサポートされていないモデルが返される 404 model_not_available;不明な機能または期限を過ぎた機能が返される 503 model_catalog_unavailable 再試行のヒント付き。他の適格な既知のアカウントは、ピアの検出が失敗した場合でもモデルを提供する可能性があります。
ネイティブ リクエストは、モデルを報告する許可された利用可能なアカウントの中から選択します。アカウントの選択と予約は、既存のトランザクションとプロセスのロックを共有します。既存のネイティブ会話では、プロバイダー間で単一のアカウント バインディングが維持されます。クライアントが明示的にモデルを変更し、完全なポータブル履歴を送信すると、新しいモデルをサポートしていないアカウントを、同じプール内の適格なアカウントに置き換えることができます。現在のアカウントが新しいモデルをサポートしている場合、そのモデルは選択されたままになります。変更されていないモデルの飽和、クールダウン、削除、無効化、およびサポートの喪失によって、自動フェイルオーバーが発生することはありません。
プロバイダーの継続はアカウントを保持します。以前の応答または保存された会話参照、アイテム参照、暗号化された推論/圧縮、署名された Claude 思考および Gemini キャッシュされたコンテンツ/署名は、モデルの切り替えを承認できません。インクリメンタル WebSocket ターンではモデルを変更できません。独立した全履歴を送信する response.create 代わりに回ります。 HTTP previous_response_id 拒否されたままです。その参照なしで完全な入力を送信します。サポートされていないバインドされたリクエストが返される conversation_account_unavailable.
既存の account_affinity テーブルにはネイティブ ルーティングが保存されます。 auto 追加的な移行を通じて正規化されたモデルをスコープし、記録します。不明なモデル メタデータを持つアップグレードされたバインディングは、サポートされるリクエストによってモデルが記録されるまで固定されたままになります。利用できない場合は、新しい会話を開始します。アカウントやアップストリーム セッション ハッシュを変更せずに、単一のレガシー プロバイダー バインディングが採用されます。同じセッション下の複数のレガシー バインディングはあいまいなままです。明示的なレガシー プレフィックス リクエストは、プロバイダーがアクティブな場合にのみ、プロバイダー固有のバインディングを保持します。永続的な API キー/アカウント バインディングは追加されません。
UIとブラウザAPI
- アカウント → モデル アカウントの最後に報告されたモデル ID、観察時間、および同期状態を手動で更新して表示します。
- リソースグループ → モデル に、自動的に派生され、ポリシーでフィルタリングされたプール カタログを示します。プール編集者は引き続きホワイトリストを個別に管理します。
- APIキー → モデル に、現在のキーの許可されたプール カタログを示します。 CC Switch にインポート 同じカタログを使用して検索可能なモデル ピッカーを提供します。
| 終点 | アクセス | 目的 |
|---|---|---|
GET /api/accounts/{id}/models | 管理者 | アカウントのスナップショットを読み取り、古い検出をトリガーする |
GET /api/channels/{id}/models | 管理者 | アカウントのスナップショットを読み取り、古い検出をトリガーする |
POST /api/accounts/{id}/models/refresh | 管理者、正確な発信元、空の JSON ボディ | アカウントの検出を更新または参加する |
POST /api/channels/{id}/models/refresh | 管理者、正確な発信元、空の JSON ボディ | アカウントの検出を更新または参加する |
GET /api/groups/{id}/models | 管理者 | 派生プール カタログを読み取る |
GET /api/keys/{id}/models | 有効なキー所有者 | シークレットを復号化せずにアクティブなキーのプール カタログを読み取ります |
GET /v1/models | ゲートウェイベアラーキー | キーのプールの標準モデルのリストを返します。 |
パーソナル カタログ アクセスでは、キーの有効化、有効期限、失効、プール アクセスが再チェックされます。管理者は、個人エンドポイントを使用して別の所有者のキーを検査することはできません。 Responses には、サブスクリプション アカウント ID、名前、資格情報ではなく、モデルのメタデータと集計鮮度カウントが含まれます。部分的なプールの応答により、一部のアカウント カタログがすべてのモデルをサポートしているものとして扱われず、不明のままであることが明らかになります。
検証境界
自動テストでは、合成アカウントとローカルの偽のアップストリームが使用されます。これらは、再起動の永続性、権威のある空のカタログ、失敗した更新の保持/バックオフ、承認とプールの取り消しの競合、キャンセル/シャットダウン、混合アカウントのルーティング、プールのホワイトリスト、思考のバリアント、会話のアフィニティ、エンドポイントの所有権、および新しいスキーマの永続性をカバーしています。フロントエンド テストでは、カタログの状態、キーボード モデルの選択、ID 変更後の古い応答がカバーされます。 Discovery はモデルの生成を調査しません。また、上流のカタログは同期と実際のリクエストの間に変更される可能性があります。
モデルの可用性診断
プールおよび個人キー モデルのダイアログを使用すると、ネイティブ モデル ID を検査できます。結果には、新しいリクエストに対するローカルの適格性、除外理由、観察時間、既知の再試行時間が表示されます。管理者はアカウントレベルの詳細を検査できます。個人キーは、サブスクリプション ID のない集約を受け取ります。チェックでは、推論の実行、メタデータの更新、スロットの予約、会話バインディングの作成は行われません。不明な/古いデータは不明のままです。資格があるからといって上流での成功が保証されるわけではありません。キー、メンバー、および許容量の制限は引き続き適用され、既存の会話ではアカウントが維持されます。
モデルを手動でテストする
管理者は、アカウントまたは API チャネルのモデル一覧で、モデルの横にある「テスト」を選択できます。テストは実際の生成リクエストを送信し、上流サービスの利用枠と同時実行枠を消費します。タイムアウトは 30 秒です。結果には、テスト時点での対象リソースの成否、安全なエラー情報、所要時間(ミリ秒)が表示されます。個人キーのグループアクセス権や利用割当は検証しません。上記のローカルな可用性診断は生成リクエストを送信しません。
上流での表示設定とルーティング能力は別です。非表示モデルはブラウザーの一覧や GET /v1/models には表示されませんが、アカウントが対応し、現在のモデルポリシーが許可していれば、ID を明示したリクエストを処理できます。非表示モデルにも権限、利用枠、同時実行数の制限が適用されます。
内部モデルの表示と呼び出し
Antigravity の isInternal、Grok Build の hidden または _meta.hidden モデルは呼び出し可能です。ログイン後のアカウント、リソースグループ、個人キーのモデル画面では、可視モデルの後に非表示モデルのラベル付きで表示し、各グループ内をアルファベット順に並べます。GET /v1/models と CC Switch のモデル候補には含めません。明示的な呼び出しにもモデルポリシー、権限、クォータ、利用枠、容量、クールダウン、アカウント状態の検査を適用します。Grok は認証済みサブスクリプションのカタログを読み、選択名をネイティブなルーティング ID に正規化します。古いカタログは表示情報を取得するため自動更新されます。