为开发者工具团队构建

提供模型选择,而不让产品沦为密钥管理器

开发者工具可通过一次网关接入开放经过审查的模型候选,同时显式保留协议与能力差异。独立限定 Key 让环境和产品入口可归因,也无需分发供应商凭证。

最后复核 2026-08-15 · 编辑复核: KeepRouter Editorial

建立窄而可靠的目录,不要倾倒模型下拉框

只有在产品里真正可用时,模型选择才有价值。先从工具实际使用的客户端协议、流解析器、工具 schema、上下文需求和最高可接受成本出发。即使网关目录更广,也只公开跑通过这些路径的 ID。

产品架构

KeepRouter Key 应保留在服务端。用经过审查的配置文件把用户可见名称映射到 canonical 模型 ID。为生产、预发、后台任务和内部评估拆分 Key,并为每个 Key 设置模型白名单与消费控制,避免一次 UI 修改解锁无关模型。

让兼容性可见

OpenAI 兼容和 Anthropic 兼容描述请求格式,不代表模型行为一致。开发者工具应说明实际使用路径、是否启用工具和图像、流如何结束,以及配置 ID 不可用时会怎样。每个选项应链接实时模型页,而不是复制价格快照。

可回滚发布

先向内部账号发布候选,再给小范围用户,最后进入公共选择器。记录模型 ID、应用版本、请求状态、token、成本和任务结果。把旧 ID 保留为已评估回滚,但不要自动重放带副作用的工具调用。

面向用户的信任界面

说明工具使用路由中间层并链接数据处理说明。若传递用户内容,应定义自己的留存和同意政策;KeepRouter 的日志边界不能替代你的义务。提供错误参考与路由状态链接,而不是承诺上游永不中断。

常见问题

开发者工具应开放完整目录吗?

通常不应。应开放与工具协议和工作流匹配、测试过的候选集。

网关 Key 应放在哪里?

应保留在服务端,不要把可复用密钥打包进浏览器或桌面应用。

可以按产品入口归因用量吗?

可为环境、服务或入口使用独立限定 Key,再把网关记录与产品事件结合。

应该如何展示价格?

链接实时目录或消费其公开数据,避免把静态价格表复制进产品文案。

参考的一手资料

  1. [1] KeepRouter OpenAPI
  2. [2] KeepRouter live model catalog

继续阅读

从一次有边界的请求开始

创建限定 free 模型的 Key,先验证客户端链路,再从实时目录批准付费模型。

创建免费 Key · 查看实时模型与价格 · 阅读 Markdown 版本