先找症状,再看原因。下面每条都点出真正决定结果的那个对象,方便你直接去核对。
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、输出、凭据或客户数据。