模型目录

模型列表为空，或需要限制可用模型时，再查这篇。首次使用只需选择池中实际提供的模型，见第一次使用。

查看模型

管理员在「订阅账号 → 模型」查看账号上次返回的模型与同步时间，在「资源组 → 模型」查看资源组的汇总结果。成员在「API 密钥 → 模型」查看自己的可用模型。客户端调用 GET /v1/models，使用个人 Bearer 密钥认证。

账号、资源组和密钥目录使用上游原生模型 ID，不额外添加服务商前缀。符合条件的 Codex、Claude、Antigravity、Grok Build 和兼容 OpenAI 的 API 资源按资源组路由与回退策略参与目录；公开目录过滤隐藏模型。相同可见 ID 合并显示，多个服务商提供可见路由时以 sublane 作为 owned_by。思考变体使用发现的基础模型判断能力，权限检查仍保留完整请求 ID。汇总目录最多包含 4,096 个模型 ID。旧的服务商前缀请求仍兼容，显式前缀会缩小候选范围。

模型目录示例（模型 ID 为合成数据）：

模型能力

账号、API 渠道、资源组和个人密钥的模型弹窗会展示上游明确报告的上下文窗口、最大输出 Token、推理级别、图片输入和工具调用支持。未报告的信息显示「未知」，与明确报告「不支持」区分。客户端 GET /v1/models 也会返回密钥可用模型的已知能力字段。

同一模型 ID 由多个资源提供时，资源组和密钥目录采用最低已知限额，以及每个允许调用的资源均确认的共同能力；信息缺失时保持未知。隐藏但可调用的路由也参与这一保守比较，但不会因此出现在客户端公开目录中。能力信息不授予权限、不改变路由，也不代表生成验证成功；旧快照通过现有发现机制刷新。

同步与有效期

导入、OAuth 完成或重新授权后启动发现。旧账号在读取目录或首次请求时按需发现；重新授权会清除旧目录。手动「验证连接」和「刷新模型」使用同一发现机制。

快照在 15 分钟内视为新鲜。过期读取先返回已有结果并触发共享后台刷新；空闲时不周期轮询。刷新失败保留上次成功快照与时间，退避 30 秒；手动刷新有 5 秒冷却。超过 24 小时的目录仍供管理员查看，但不再用于公开目录与路由。

成功获取的空列表表示已知不支持任何模型；没有快照表示能力未知，两者不同。单账号最多记录 512 个模型 ID。最多同时执行两个发现操作，并计入工作空间操作容量；该容量默认 128，可通过 SUBLANE_GATEWAY_CAPACITY 调整。

组目录与推理

组目录是启用且可用的订阅账号目录并集，再应用 精确白名单。它不是第二份可编辑权限策略。停用、需要重新授权的账号不参与目录，未知账号不会被当成支持全部模型。

路由先检查具体账号是否支持模型，再执行并发、冷却与轮换规则。已知不支持返回 404 model_not_available；能力未知或过旧可能返回 503 model_catalog_unavailable。一个账号发现失败，不妨碍其他已知可用账号提供服务。

现有对话保持账号绑定。客户端主动更换模型、携带完整且可跨提供商重放的历史时，如果原账号不支持新模型，可在同一资源组内选择符合权限、配额与容量限制的账号；原账号支持新模型时继续使用原账号。同模型请求不会因模型目录变化、冷却、繁忙、停用或移除而自动换号。

上游续接请求保留账号绑定。previous_response_id、存储会话或消息引用、加密推理/压缩内容、Claude 思考签名、Gemini 缓存引用或签名都不能触发跨账号切换。WebSocket 增量回合不能更换模型；需要发送携带完整历史的独立 response.create。HTTP 仍拒绝非空的 previous_response_id，需去掉该引用并提供完整输入。无法继续使用绑定账号时返回 conversation_account_unavailable。

升级通过增量迁移给已有绑定增加模型元数据。未记录原模型的旧绑定保持原账号，直到一次支持的请求补齐模型信息；无法补齐时请新建会话。更改 Codex 版本策略 会触发按需重新发现，不会改写组白名单。

接口

个人结果不包含订阅账号身份或凭据。合成测试覆盖目录持久化、刷新竞态与权限撤销；发现接口本身不会探测模型生成。

模型可用状态诊断

在资源组或个人密钥的模型弹窗中，点击模型或填写原生模型 ID 后检查状态。结果展示新请求的本地准入条件、排除原因、观测时间和已知可重试时间。管理员可查看账号级详情；个人密钥只返回汇总，不披露订阅账号身份。检查不会发送生成请求、刷新模型或额度、占用槽位或建立会话绑定。未知和过期数据保留为未知。符合条件不保证上游生成成功；实际请求仍检查密钥、成员与用量分配限制，已有对话保持原账号绑定。

手动检测模型

管理员在「订阅账号」或「API 渠道」中打开「模型」，点击模型旁的「检测」。每次检测会发送真实生成请求、消耗上游额度并占用并发容量，30 秒后超时。结果展示此资源在检测时是否成功、经过脱敏的错误及耗时（毫秒），不验证个人密钥的资源组权限或用量分配。上面的本地可用状态诊断不会发送生成请求。

登录后的浏览器模型目录会显示隐藏能力并标注「隐藏模型」；客户端公开目录和 CC Switch 建议列表仍过滤它们。展示状态不会改变模型调用的权限、配额或容量检查。

内部模型的展示与调用

Antigravity 标记为 isInternal 的模型，以及 Grok Build 标记为 hidden 或 _meta.hidden 的模型，会保留为可调用能力。登录后的账号、资源组和个人密钥模型弹窗会展示它们，标注「隐藏模型」，排在可见模型之后，两组各按字母顺序排列；GET /v1/models 和 CC Switch 模型选择器仍过滤它们。显式请求仍执行模型策略、权限、配额、用量分配、容量、冷却和账号生命周期检查。Grok 从已认证的订阅目录发现模型，将选择器别名规范化为原生路由 ID；旧目录会自动刷新以获取展示元数据。