模型库与供应商
模型库位于 ⚙ 设置 → 模型，是模型与凭据的唯一编辑处。顶栏模型切换器只决定当前聊天用哪个模型；设置 → 编程 Agent 决定每个 Agent 使用库里的哪个模型，以及是否经网关接入。
供应商 → 模型两层结构#
一条供应商包含一份凭据、可选的 对话 / Anthropic / OpenAI 三种端点，以及一份模型清单。同一供应商下的多个模型共用一份 key，配一次即可供聊天、编程 Agent 与审计评估使用。每个模型独立维护启用状态、上下文窗口、能力和思考档位。
添加供应商与认证#
点 + 添加供应商，从 200+ 家供应商目录中选择。目录由 models.dev 蒸馏快照与内置覆盖层组成，编译进应用，浏览目录本身不联网。
目录没有的服务商选择 自定义，填写 OpenAI 兼容端点；Ollama、LM Studio、vLLM 和自托管网关都可以这样接入。
同一服务商可以建立多条账号，使用不同 key、分别命名并接入不同 Agent。
认证方式：
API Key：只存系统钥匙串，模型库文件不保存 key。
供应商 OAuth：Kimi Coding Plan 使用设备码；“OpenAI ChatGPT 订阅（Codex）”专用入口使用浏览器授权。token 只存系统钥匙串，前端拿不到原文。OpenAI API Key 条目与 Anthropic 条目仍只提供 API Key。
ChatGPT 订阅的范围：仅用于四家编程 Agent 经网关的 Responses 适配，不作为 Kaya 聊天模型。已提供授权入口，真实登录与刷新仍待真机验收。
本地端点免 key：
localhost/127.0.0.1的本地服务可以不填 key。
在线模型发现#
保存非空 API Key 后自动获取一次模型清单；详情页也可以随时点 刷新。
请求只发往该供应商自己的端点，只在你操作时触发，没有后台轮询。
失败会标明鉴权、网络、超时、响应过大等原因；目录供应商回退到快照并标注「可能滞后」。
手工增补的模型不受影响，一次网络失败也不会删除此前发现的模型。
每个模型能声明什么#
| 项 | 说明 |
|---|---|
| 启用 | 是否出现在投影和模型选择器中 |
| 上下文窗口 | 支持精确 token 数或 256K / 1.5M 简写；留空表示未知 |
| 输出上限 | 供需要该字段的 Agent 使用；未知时使用保守缺省 |
| 图片输入 | 自动 / 支持 / 不支持；自动按供应商目录 → LiteLLM 快照判定 |
| 思考 | 自动 / 支持 / 不支持；显式声明优先于目录 |
| 思考档位 | minimal / low / medium / high / xhigh / max 多选及默认档，投影到各 Agent 的原生配置 |
| 视频 / 音频 | 可按模型声明输入能力，目前由 kimi-code 消费 |
「清除声明」会同时移除思考与档位声明，恢复按目录自动判断。
改动、状态与诊断#
修改供应商后，已接入的 Agent 自动跟随，无需重新绑定。
清空 API Key 会使网关里的对应凭据失效；删除供应商会同时删除该 key，并让接入的 Agent 退出 Kaya 配置。
未接入的 Agent 不受影响。
支持的供应商可显示账号余额；查询只读，key 仅随鉴权请求发给对应服务商。
测试连接只判断端点是否可达，不验证具体模型能否工作，也不写库。
接入状态逐个 Agent 显示缺凭据、端点停用、协议不兼容或模型停用等原因；网关未运行时明确显示状态未知。