Skip to content

排障

认证、Pool 缺失、限额与证据的常见症状、原因与修法。

Updated View as Markdown
For humans

先找症状,再看原因。下面每条都点出真正决定结果的那个对象,方便你直接去核对。

Gateway 返回 401

原因: Key 缺失、格式不对、已吊销、签发给了另一个 Environment,或者属于另一个 Home Cloud。

修法: 用 Authorization: Bearer <key> 发送;确认这个 Key 仍出现在你调用的 Environment 的 API keys 里;确认 Workspace 的 Home Cloud 与 Key 一致。

我的 Pool 不在 GET /v1/models 里

原因: 这个接口只列 Key 真正能调用的东西。Key 没有被授权、Pool 已暂停、Agreement 不覆盖该能力、 provider 连接不可用,或 fallback 策略无法满足,都会让 Pool 消失。

修法: 先查 Pool 的状态与授权,再查 provider 连接,最后查该项能力的权益。

429 quota_runtime_rate_limit_exceeded

原因: 触到了 Pool 的每分钟上限,或按 Key 的上限。

修法: 等窗口重置、有意地调高上限,或把流量拆到多个 Key 上。立刻重试只会更糟。

429 quota_hard_budget_exceeded

原因: Pool 的剩余硬预算不足以覆盖这次请求。错误体里带着上限与剩余金额。

修法: 调高 Pool 预算、等下个周期,或把低优先级负载挪到另一个 Pool。Gateway 宁可拒绝请求,也不 赊账服务。

控制台显示 Unavailable

原因: 快照在这个区间、作用域或字段上还没有证据。

修法: 检查时间窗和当前选中的 Pool。AI Runtime 不会把从未观测过的时段写成零,也不会用单次观测 画曲线。

我需要那次失败请求的确切记录

用错误体里的 requestId,或响应头里的 x-airuntime-request-id,在控制台打开 Requests。 幂等重放保留第一次的 Request ID,所以重试不会盖掉原始那一次。

Codex 里没有我要的模型

原因: Codex 发的是它目录里的模型名,而那个名字必须是这个 Key 能调用的 Pool slug。

修法: 把 ~/.codex/config.toml 里的 model 和 Pool slug 对一遍,再确认 GET /v1/models 用同一个 Key 能返回它。接入 Codex 把整个文件讲了一遍。

还是卡住了?

用联系表单,或写 support@gridheap.com,附上 Workspace id、Pool slug、UTC 时间和 requestId。 不要发送 prompt、输出、凭据或客户数据。

Type to search…

↑↓ navigate↵ selectEsc close