参考
本页内容
Model Router 的完整参考表。如需了解概念和任务指南，请从概述开始。
模块
| 项目 | 值 |
|---|
| 菜单位置 | 主菜单 → Model Router，位于 AI Modules & Agents 分组中 |
| 谁可以访问 | 仅限 Organisation Administrator（Technology Stack 设施）。 |
| 范围 | 按设施（在主工具栏中选择设施） |
| 货币 | USD |
充值
| 设置 | 值 |
|---|
| 最低充值金额 | $10 |
| 单次充值最高金额 | $5,000 |
| 预设金额 | $25、$50、$100、$250、$500、$1000 |
| 付款方式 | 设施已保存的账单卡 |
| 余额入账时间 | 即时 |
| 收据 | 每笔充值提供收据编号 + 可下载的 PDF；同时通过电子邮件发送给设施的账单联系人 |
自动充值
| 设置 | 值 |
|---|
| 触发条件 | 余额低于您设置的 When balance is below 阈值 |
| 充值金额 | 您设置的 Top up by 金额（最低 $10） |
| 检查频率 | 大约每 15 分钟一次 |
| 失败处理 | 在以下情况下显示横幅：没有已存档的卡、卡需要验证、卡被拒绝 |
使用情况与核对
| 项目 | 值 |
|---|
| 使用情况核对 | 每 15 分钟与预付余额核对一次；显示在 Monthly usage 中，按日历月 (UTC) 分组 |
| Available balance | 实时：已入账总额减去实时支出（不仅仅是已核对的账目） |
| Estimated runway | 根据本月平均每日支出对余额进行的预测；显示为 0 days、1 day、N days、365+ days 或 Not enough data |
账户支出限额
| 限额 | 重置 | 预设金额 |
|---|
| 每日限额 | 每天在设施当地时间午夜 | $25、$50、$100、$250 |
| 每月限额 | 每月 1 日，设施当地时间 | $50、$100、$250、$500、$1000 |
| 总额（硬性上限） | 仅限手动重置（Reset hard cap：计数器归 $0，上限不变，已结束的周期保存到重置历史记录中） | — |
可以同时启用任意组合。限额适用于所有 API 密钥和已连接服务的合计支出；预付余额仍会叠加生效。超出限额时，请求将因 402 budget_exceeded 错误而被阻止，直到时间窗口重置。
按密钥/按服务设置
| 设置 | 默认值 | 说明 |
|---|
| 标签 | 空 | 可选；用于在 Activity 和 Logs 中归属使用情况 |
| 连接类型（仅限 API 密钥） | API key | API key 保留在 API 密钥列表中；External agent 显示在 Connected Services 下 |
| 每日支出限额 | 关闭 | 在每天开始时重置，按设施时区 |
| 每月支出限额 | 关闭 | 在每月 1 日重置，按设施时区 |
| 终身上限 | 关闭 | 密钥或服务整个生命周期内的总支出；永不重置 |
| Requests / min | 不限 | 超出时返回 HTTP 429 |
| Tokens / min | 不限 | 超出时返回 HTTP 429 |
| 限制模型 | 关闭（所有设施已启用的模型） | 此密钥或服务只能使用所选模型 |
| 覆盖设施防护规则 | 关闭（沿用设施设置） | 开启后，应用该密钥或服务自己的选择，包括“无” |
API 密钥状态和操作
| 状态 | 含义 |
|---|
| Active | 密钥可用。 |
| Provisioning… | 在设置新密钥期间短暂显示。 |
| Disabled | 密钥已被吊销（该行显示为灰色）；可以重新激活。 |
| 操作 | 可撤消？ | 效果 |
|---|
| Edit | — | 更改标签、限额、模型、防护规则。 |
| Rotate | 否 | 签发新密钥（只显示一次）；旧密钥立即失效。 |
| Revoke | 是（Re-activate） | 密钥立即被禁用。 |
| Delete | 否 | 密钥被永久删除。 |
模型
| 项目 | 值 |
|---|
| 默认 | 启用目录中的所有模型 |
| Automatically enable new models | 开启后，新添加到目录中的模型会自动为该设施开启 |
| 约束 | "At least one model must stay enabled."（至少必须保留一个已启用的模型。） |
| 快速预设 | All models、Frontier、Western providers、Open weights、Budget（输入价格 ≤ $1.00 / 1M tokens） |
| 筛选器 | Status（Any/Enabled/Disabled）、Region（United States/Europe/China）、Capability（Vision、Audio、PDF input、Reasoning） |
| 排序 | Recommended、Name、Price、Context size，升序/降序 |
| 按模型信息 | 上下文窗口、每 1M 令牌的输入和输出价格、能力图标（文本、图片、音频、PDF）、推理设置 |
自动路由器
| 层级 | 说明 |
|---|
| Simple | 简短、直接的提示 |
| Medium | 日常任务 |
| Complex | 困难的多步骤工作 |
| Reasoning | 深度推理和分析 |
- 模型 ID：
auto；Usage-priced（按使用计价）：按路由器为每个请求选择的模型的费率计费。
- 可通过 Edit routing 按设施编辑路由（只能选择已启用的模型；每个层级都必须有一个模型）；Reset to default 可恢复标准映射。
- Logs/Activity 显示解析出的模型；请求抽屉将
auto 显示为 Requested model。
安全护栏
| 防护规则 | 匹配时的操作 |
|---|
| PII masking | 遮蔽提示中的个人数据；请求继续 |
| Secret redaction | 从提示中移除密钥/令牌/机密信息；请求继续 |
| Prompt-injection shield | 阻止请求（403 content_policy_violation） |
| 模板 | 启用内容 |
|---|
| None | 无（默认） |
| PII protection | PII masking |
| Secret redaction | Secret redaction |
| Injection shield | Prompt-injection shield |
| Strict | 全部三项 |
内容过滤器
| 项目 | 值 |
|---|
| 每个设施的最大过滤器数 | 25 |
| 最大模式长度 | 300 个字符 |
| 操作 | Redact（将匹配项改写为 [REDACTED]）或 Block（以 403 拒绝） |
| 模式安全性 | 不安全的正则表达式（例如容易出现灾难性回溯的模式）以及超过 300 个字符的模式会被丢弃且不会应用 |
| 继承 | 设施范围；启用了防护规则覆盖的密钥和服务使用自己的列表 |
交易历史记录
交易历史记录只列出充值和余额调整。使用费用汇总在 Monthly usage 中。
| 类型 | 含义 |
|---|
| Top-up | 为余额入账的卡扣款 |
| Refund | 已退款的扣款 |
| Adjustment | 手动余额更正 |
| 项目 | 值 |
|---|
| 列 | Date、Type、Amount、Balance after、Receipt |
| 批量收据 | 勾选行，然后点击 Download receipts (n) |
每月使用情况
| 项目 | 值 |
|---|
| 分组 | 日历月 (UTC)；当前月份标记为 Month to date |
| 核对 | 每 15 分钟与预付余额核对一次 |
| 列 | Month、Usage、Deductions、Downloads |
| 扣款类型 | Usage charge（已核对的推理支出），在展开月份时列出 |
| 每月下载内容 | Download usage statement (PDF) 和 Download usage detail (CSV) |
| 性质 | 使用情况对账单，而不是发票；只有卡充值才有收据 |
活动与日志
| 项目 | 值 |
|---|
| Activity 视图 | Overview、Trends、Performance、Explore |
| 范围预设 | Last 24 hours、Last 7 days、Last 30 days、Last 90 days、Year、All time、Custom range |
| Logs 范围预设 | Last 15 minutes、Last hour、Last 24 hours（默认）、Last 7 days、Last 30 days、自定义；Live 刷新 Off / 10s / 30s（默认）/ 60s |
| Explore 分组选项 | Model、API key / agent、Source、Provider、Status |
| 原始 CSV 导出上限 | 25,000 行 |
| 导出类型 | 原始请求；按模型 / 按密钥和代理 / 按来源 / 按周期汇总（汇总以整天为单位） |
| 存储的内容 | 仅元数据，绝不包含提示或响应内容 |
API 错误响应
基础 URL：显示在 Settings → Service Access & API Keys → Connecting to the API 中（例如 https://app.performancehub.co/ai/v1）。错误使用 OpenAI 封装格式 { "error": { "message", "type", "code" } }。
| HTTP | type | code | 含义 |
|---|
| 401 | invalid_request_error | invalid_api_key | 缺少 API 密钥，或已连接服务的凭据无效 |
| 401 | invalid_request_error | — | 未知或已吊销的 API 密钥（"Invalid API key"） |
| 402 | insufficient_quota | insufficient_credits | 预付余额已耗尽（对于已连接服务，也可能是设施未启用该模块） |
| 402 | insufficient_quota | budget_exceeded | 已达到支出限额（设施、密钥或已连接服务）；响应正文包含 window、resetsAt、timezone、docsUrl |
| 403 | invalid_request_error | — | "Model Router is not enabled for this facility"（API 密钥），或 "Facility has no provisioned inference key"（该密钥没有对应的推理密钥） |
| 403 | invalid_request_error | content_policy_violation | 被内容过滤器或提示注入防护阻止 |
| 429 | — | — | 超出每分钟请求数或每分钟令牌数速率限制 |
| 502 | server_error | — | 上游推理服务不可用（请重试） |
检查 API 密钥时发生意外故障会返回 HTTP 500 "Something went wrong"；请重试该请求。
余额为零时，GET /v1/models 仍然可用。
