为开发者工具团队构建
提供模型选择,而不让产品沦为密钥管理器
开发者工具可通过一次网关接入开放经过审查的模型候选,同时显式保留协议与能力差异。独立限定 Key 让环境和产品入口可归因,也无需分发供应商凭证。
最后复核 2026-08-15 · 编辑复核: KeepRouter Editorial
建立窄而可靠的目录,不要倾倒模型下拉框
只有在产品里真正可用时,模型选择才有价值。先从工具实际使用的客户端协议、流解析器、工具 schema、上下文需求和最高可接受成本出发。即使网关目录更广,也只公开跑通过这些路径的 ID。
产品架构
KeepRouter Key 应保留在服务端。用经过审查的配置文件把用户可见名称映射到 canonical 模型 ID。为生产、预发、后台任务和内部评估拆分 Key,并为每个 Key 设置模型白名单与消费控制,避免一次 UI 修改解锁无关模型。
让兼容性可见
OpenAI 兼容和 Anthropic 兼容描述请求格式,不代表模型行为一致。开发者工具应说明实际使用路径、是否启用工具和图像、流如何结束,以及配置 ID 不可用时会怎样。每个选项应链接实时模型页,而不是复制价格快照。
可回滚发布
先向内部账号发布候选,再给小范围用户,最后进入公共选择器。记录模型 ID、应用版本、请求状态、token、成本和任务结果。把旧 ID 保留为已评估回滚,但不要自动重放带副作用的工具调用。
面向用户的信任界面
说明工具使用路由中间层并链接数据处理说明。若传递用户内容,应定义自己的留存和同意政策;KeepRouter 的日志边界不能替代你的义务。提供错误参考与路由状态链接,而不是承诺上游永不中断。
常见问题
开发者工具应开放完整目录吗?
通常不应。应开放与工具协议和工作流匹配、测试过的候选集。
网关 Key 应放在哪里?
应保留在服务端,不要把可复用密钥打包进浏览器或桌面应用。
可以按产品入口归因用量吗?
可为环境、服务或入口使用独立限定 Key,再把网关记录与产品事件结合。
应该如何展示价格?
链接实时目录或消费其公开数据,避免把静态价格表复制进产品文案。