# 按明确模型 ID 路由，并保留可核验的运行边界

> KeepRouter 将公共模型 ID 的请求路由到符合条件的配置线路。公共响应保留请求的 canonical 身份，而线路健康与可用性被当作可观测的运行问题，而不是隐藏的营销承诺。

_最后复核 2026-08-15 · [编辑复核](https://keeprouter.com/editorial-policy#editorial-team)_

## 先明确选择

每个请求都命名实时目录中的模型。这样应用行为可审查：模型 ID 会出现在配置、请求日志、用量报告和公共模型页。KeepRouter 不要求使用会在没有应用决策时改变质量或价格的模糊“智能”别名。

## 路由如何选择

网关在转发前检查认证、Key 限制、公开价格、路由兼容性和配置线路健康。当存在多条合格线路时，可按网关策略使用可用候选。成功响应会规范回公共模型身份，避免上游版本标签污染应用的模型计量。

## 路由不保证什么

已配置路由不是永久可用承诺。供应商故障、限流、地区限制、参数不兼容和账户余额不足都可能让请求失败。公共[状态页](/status)报告 KeepRouter 数据库与路由配置健康，并明确不声称已经探测每个上游模型。

生产客户端应该：

- 设置连接和总超时；
- 只对安全的暂时性错误做带抖动重试；
- 不重试认证、校验或额度不足错误；
- 为工具或副作用工作流保留幂等性；
- 记录请求模型和 request ID；
- 只在测试过语义差异后使用应用自有 fallback。

## 稳定公共 ID 与滚动后端

部分模型厂商在更新后台版本时仍保留稳定 API ID。KeepRouter 目录记录可调用稳定 ID；带日期或供应商内部标签不会自动成为单独公共产品。这样 Key、价格、日志和模型页都围绕客户实际发送的 ID 对齐。

## 把 fallback 设计成产品行为

自动 fallback 可以保持端点可用，却可能改变输出风格、上下文限制、工具行为或成本。请按任务决定可接受的转换，限制最高价格，并把 fallback 事件暴露给应用遥测。只有结果仍满足产品契约时，可用性才真正有价值。

## 常见问题

### KeepRouter 会自动选择任意模型吗？

不会。请求明确指定公共模型 ID，路由只为该 ID 选择合格配置线路，不会换成无关模型。

### 状态页会探测每个上游模型吗？

不会。它报告网关数据库、schema 与路由配置健康；真实模型调用属于另一层证据。

### 为什么要保留稳定模型 ID？

上游滚动后台版本时，稳定可调用 ID 能让配置、Key 策略、定价、日志和公开文档保持一致。

### 应用仍需要实现重试吗？

需要。只对暂时性错误做有界重试，不能假设网关取代了超时、幂等和错误策略。

## 参考的一手资料

1. [KeepRouter OpenAPI](https://keeprouter.com/api/openapi.json)
2. [KeepRouter live model catalog](https://keeprouter.com/models)
3. [KeepRouter service status](https://keeprouter.com/status)

## 继续阅读

- [LLM 路由与负载均衡：团队最常混淆的四种策略](https://keeprouter.com/zh/blog/llm-routing-vs-load-balancing.md)
- [API 可观测性](https://keeprouter.com/zh/features/api-observability.md)
- [status](https://keeprouter.com/status.md)
- [errors](https://keeprouter.com/docs/errors.md)

## 上线前检查路由契约

选择模型，运行有上限的请求，再检查状态、模型身份、token、费用与延迟。

[创建免费 Key](https://keeprouter.com/login?returnTo=%2Fconsole%2Fkeys%3Fmodel%3Dfree) · [实时模型与价格](https://keeprouter.com/models.md)