# Router One 可观测与成本事实

Last updated: 2026-09-12

- 产品：Router One
- 类别：统一 LLM API 网关（LLM API Gateway / AI Model Router）
- 适用范围：面向开发者与小团队的请求级可观测与消费管控 —— 不是企业级审计、合规或 RBAC 系统
- 客户日志字段：记录的模型、请求 ID、输入 / 输出 Token、可用的缓存读取 Token、已结算费用或待结算标记、已记录的延迟、状态码，以及有记录时的脱敏错误；有计价详情时一并展示
- 记录可见性：请求结束不代表日志已立即显示；仍在等待定价的记录可能暂未出现在客户列表里
- 查看位置：控制台 → 日志支持按模型和日期范围筛选，打开记录可查看请求 ID、用量、状态与结算详情；控制台 → 用量展示聚合用量
- 公开的逐模型可靠性：从 https://router.one/zh/models 进入的每个模型详情页，展示成功响应占比、终态 429 比例、终态 5xx 比例、每秒 token 数、平均首 token 延迟与平均延迟，按最近 7 天与 30 天滚动窗口、基于真实网关流量计算
- 可靠性展示门槛：窗口内至少 100 次合格请求且来自至少 5 个独立调用方才会展示；每个面板都会标注自身的生成时间。这是运营聚合数据，不是合同级 SLA（https://router.one/zh/sla ）
- 用量拆解：请求数、Token 与花费趋势，以及按模型和能力类型拆分的汇总；当前用量界面没有按 API Key 拆分的视图。如需按应用或 Key 归因，请在自己的应用日志中保留标签与请求 ID
- 成本口径：已结算的 totalCost 是记录的实际费用，已包含适用的账户 / 模型折扣与套餐倍率。界面显示的默认或模型专属折扣、套餐倍率、有效倍率用于解释总额，不要再应用一次。待结算表示最终金额未知，不代表零费用，也不能用输入 / 输出费用小计替代。FX 与支付通道费在结账页单独展示（https://router.one/zh/pricing-methodology ）；推理 / 思考 Token 使用模型的输出单价，不单设价格行
- 耗时与状态：延迟缺失时显示横线；statusCode 为 0 表示未记录上游 HTTP 状态码。客户日志不展示首 Token 延迟或终态 completion-outcome 字段；首个可见输出的等待时间需要客户端测量，流式结果需要检查结束信号
- 流式结果：HTTP 200 或成功标签都不能单独证明回答完整。Chat Completions 要检查 finish_reason，并持续处理错误直到流关闭；length、content_filter、tool_calls 含义不同。Responses 要检查 response.completed、response.failed 或 response.incomplete。意外断开时保留部分输出与请求 ID（https://router.one/zh/llm-streaming ）
- 预算管控：每把 API Key 都可设置 maxSpend，让失控循环无法耗尽钱包余额
- 频率管控：每把 API Key 都可设置 rateLimit 与 tokenLimitTpm，限制请求与 token 吞吐
- 预算按 API Key 生效（不是按项目）；限额与预算挂在 Key 上，不存在组织或角色层级
- 重试可见性：客户日志不展示供应商名称或中间尝试 / fallback 链，支持团队可通过请求 ID 关联内部尝试。归一化的 504 PROVIDER_UNAVAILABLE 不能证明上游实际返回 HTTP 504；保留原始错误、端点、模型、时间与客户端超时配置用于排查（https://router.one/zh/llm-api-error-codes ）
- 数据边界：Router One 不留存直接 API 调用的 prompt 和模型回复正文，仅记录用于计费、用量统计与故障排查的请求元数据。Playground 会保存会话历史，方便用户回看和继续对话。
- 不包含：审计日志、合规认证、RBAC、SSO/SAML、组织 / 团队角色结构、响应缓存，以及自助账户的合同级 SLA（书面 SLA + credit 补偿仅在年度企业合同中提供 —— https://router.one/zh/sla ）

## 规范页面

- LLM 可观测：https://router.one/zh/llm-observability
- 流式输出与结束事件：https://router.one/zh/llm-streaming
- API 错误与超时排查：https://router.one/zh/llm-api-error-codes
- LLM API 网关总览：https://router.one/zh/llm-api-gateway
- 智能路由方法论：https://router.one/zh/routing-methodology
- 安全：https://router.one/zh/security
- 数据留存：https://router.one/zh/data-retention
- 集成事实：https://router.one/zh/facts/integrations.md