故障排除

请对照您看到的症状逐项排查。几乎在所有情况下，Logs 选项卡都是最快的诊断方式：它会显示每个请求的状态以及失败模式（是某一个密钥？某一个模型？还是全部？）。请参阅活动和日志。

请求被阻止

每个请求都因 402 insufficient_credits 而失败

**原因：**该设施未启用此模块，或预付余额已用尽（Overview 选项卡将显示 "Your balance is depleted. Inference requests will be blocked until you top up."）。对于 API 密钥，如果设施未启用 Model Router，则会改为返回 403 "Model Router is not enabled for this facility"。

**解决方法：**在 Welcome to Model Router 页面启用 Model Router（请参阅入门），然后在 Budgets & Limits → Balance & Top-up 中充值。余额到账后，请求会在片刻内恢复。为防止再次发生，请启用自动充值。请参阅预算和充值。

请求因 402 budget_exceeded 而失败

**原因：**已达到某个支出限额。错误消息会说明是哪个时间窗口（每日/每月/终身），对于每日和每月限额，还会按您设施的时区准确说明重置时间。该限额可能是整个账户的限额，也可能是特定密钥或已连接服务的限额（限定范围时，消息中会出现 "This key's" / "This agent's"）。

**解决方法：**等待所述的重置时间，或提高限额（Budgets & Limits → Spend Limits，或在密钥或服务的配置中），对于终身硬上限，则使用 Reset hard cap。Spend Limits 页面会准确显示哪些限额处于 "Limit reached" 状态。

请求因 403 content_policy_violation 而失败

**原因：**提示词匹配了 block 模式的内容过滤器或提示词注入防护。

**解决方法：**检查 Settings → Guardrails。如果某个集成确实需要不同的规则，请使用其 Override facility guardrails 开关，而不是放宽整个设施的策略。请参阅防护措施。

请求因 429 而失败

**原因：**密钥或已连接服务超出了其 Requests / min 或 Tokens / min 速率限制。

**解决方法：**降低请求频率后重试，或在密钥或服务配置中提高速率限制（留空 = 无限制）。请参阅 API 密钥。

某个特定模型返回错误，其他模型正常

**原因：**该模型可能已对您的设施禁用、被密钥的模型限制排除，或者提供商可能出现了问题。

**解决方法：**检查 Settings → Models（是否已启用？）、密钥的 Restrict models 列表，以及 Activity → Performance → Reliability & performance by model 中该模型随时间变化的错误率。

API 密钥问题

401 Unauthorized

**原因：**如果代码为 invalid_api_key（"Missing or invalid API key"），说明 Authorization: Bearer … 标头缺失或格式错误。如果没有代码（"Invalid API key"），说明该密钥未知（输错，或是 rotate 之后的旧密钥）或已被 revoked。

**解决方法：**确认标头格式；在 Settings → Service Access & API Keys 中检查密钥的状态。重新激活已撤销的密钥，或者如果密钥已轮换，则将您的服务更新为新的密钥。

我丢失了密钥

密钥仅在创建时显示一次，且无法恢复。请使用 Rotate：系统会签发新的密钥（仅显示一次），该密钥会保留其标签、限额和历史记录。请更新所有使用该密钥的服务："You will need to reconfigure any services still using the old key."

密钥可以使用，但用量显示在错误的名称下

在 Activity 和 Logs 中，密钥以其 Label 标识。请编辑密钥并设置有意义的标签；为每个系统提供单独的密钥，而不是共用一个。

代理问题

代理显示为离线

**原因：**设备已断电或没有网络连接。这是设备连接问题，而不是 Model Router 设置问题。

**解决方法：**检查设备的电源和网络。其访问配置不受影响，设备重新连接后即可恢复正常。

代理不再响应 AI 请求

按以下顺序检查：

1. 余额：余额用尽会阻止所有代理（代理会显示需要额度的状态）。请充值。
2. 单个服务限额：Settings → Service Access & API Keys → Connected Services：该代理是否显示 "Limit reached"？提高限额或等待限额重置。
3. 账户限额：Budgets & Limits → Spend Limits。
4. 日志：按代理筛选，查看其请求的实际错误。

余额和账单问题

支出数据看起来滞后

Available balance 和 Spent today 数据是实时的。Monthly usage 每 15 分钟与您的余额对账一次，因此最近的支出可能需要几分钟才会显示在其中。交易历史仅列出充值和余额调整，因此用量永远不会显示在其中。

自动充值没有运行

检查 Balance & Top-up 页面上是否有横幅提示：未登记银行卡、银行卡需要验证或银行卡被拒。修复银行卡问题（Update card / Edit payment details）或手动充值。自动充值检查大约每 15 分钟运行一次，因此刚刚越过阈值时，可能需要几分钟才会触发。

充值失败

"Additional card authentication is required. Please try again."：请重试；您的银行可能会提示进行验证。"Top-up could not be completed."：扣款被拒；请检查银行卡或尝试其他金额。只有扣款成功后才会计入额度。

已扣款但余额没有变化

充值会即时到账，请刷新页面。如果余额仍未反映成功的扣款，请记下交易详情抽屉中（或您的银行卡对账单上）的 Transaction ID 和 Payment reference，然后提出支持请求。

日志和分析问题

我刚发出的请求还没有出现在 Logs 中

开启 Live 刷新（或点击 Refresh now）。请求通常会在片刻内出现；负载较高时可能需要稍长一些时间。

日志显示了我没有请求的模型

如果您发送的是 model: "auto"，日志会显示 Auto Router 解析到的模型。打开请求详情即可看到 Requested model: auto。这是正常现象。请参阅模型。

行显示 "No charge"

不产生费用的失败或空响应会标记为 No charge：记录它们是为了完整性，但它们不会消耗余额。

我的 CSV 导出比预期的小

原始导出最多 25,000 行。请缩小日期范围或使用汇总导出。另请注意："Summaries cover whole days, so a sub-day or graph selection is widened to full days."