
Mercury Decide 429 限流怎么解决:5 个官方解法
Mercury Decide 报 429,先别急着加大重试频率。429 在 OpenRouter 上来自两个地方:平台自身的限额,或上游 provider 的限流,处理方式完全不同。按官方文档的顺序排查:先看错误体和响应头,再决定是等 Retry-After、换付费变体,还是加 fallback 模型。

429 到底是谁限的:平台还是 provider
OpenRouter 官方限流文档明确,429(error_type 为 rate_limit_exceeded)可能来自两处。
- OpenRouter 平台:免费模型有每分钟和每日的请求上限,另有 DDoS 防护。这类 429 的错误响应会带 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 头。
- 上游 provider:提供推理服务的厂商限流或容量不足。这类 429 的 error.metadata.provider_code 会携带 provider 的原始错误码。
判断方法:看错误体里的 error.metadata.error_type 是不是 rate_limit_exceeded,看响应头里有没有 X-RateLimit-* 和 Retry-After。官方文档特别说明,成功的请求不会带 X-RateLimit 头,所以只在报错时看这些信息。
排查第一步:看响应头和错误体
OpenRouter 的错误体是统一结构:
{
"error": {
"code": 429,
"message": "Rate limit exceeded",
"metadata": {
"error_type": "rate_limit_exceeded"
}
}
}
重点看两处:error_type 和 Retry-After 头。官方文档说,当所有尝试过的 provider 都返回了重试提示时,OpenRouter 会在 429 响应上带标准 Retry-After 头,指示等待秒数。OpenAI SDK、Anthropic SDK、OpenRouter SDK 会自动尊重这个头做退避,不用自己写。

5 个解法,按优先级来
- 读 Retry-After 头,等够秒数再重试。这是官方文档的首个建议,限流是瞬态的,等一会就恢复。
- 指数退避重试:没有 Retry-After 时按 1 秒、2 秒、4 秒递增并加随机抖动,最多重试 5 次左右。不要无脑连发,反而加重限流。
- 免费端点被限:免费模型有每分钟和每日请求上限,购买 credits 可提高每日上限,或直接改用付费变体。官方文档明确,付费变体没有平台级请求上限。
- provider 侧限流:加 fallback models,或放宽 provider routing preferences,让更多 provider 可以服务这个请求。OpenRouter 的 fallback routing 本来就会在 provider 限流时自动换其他 provider 重试。
- 降并发:批量任务把并发降下来,错峰跑。429 本质是请求节奏问题,不是代码问题。
官方给出的参考代码(判断 429/503/402 并读 Retry-After):
const res = await fetch('https://openrouter.ai/api/v1/chat/completions', { ... });
if (res.status === 429 || res.status === 503 || res.status === 402) {
const retryAfter = Number(res.headers.get('Retry-After'));
if (Number.isFinite(retryAfter) && retryAfter > 0) {
await new Promise((r) => setTimeout(r, retryAfter * 1000));
// retry the request
}
}

决策端点的两个特殊注意
402 和 429 别搞混
官方文档强调:402 是余额或 in-flight 预算不足,重试不会自己好,要充值或降低请求体大小。429 是限流,等一等会恢复。报错时先看 code,别把充钱当成 429 的解法。
零留存端点和 provider 路由
Mercury Decide 是 Inception AI 的零数据留存决策端点,官方入口在 openrouter.ai/inception/mercury-decide,定价为免费端点或 $0.02/M 输入且零留存,支持文本和图像输入,输出形式是一个选择、一个评分或附带概率的 yes/no。
社区接入经验提醒:零留存是端点级承诺,调用时建议固定支持零留存的 provider 路由,避免随机路由到不承诺零留存的节点,这也直接影响限流表现。完整接入流程看站内 Mercury Decide API Key OpenRouter 接入。
Mercury Decide 定位是决策型端点,适合工单分类这类短输出高频调用,限流影响更明显。价格对比看站内 Mercury Decide 和 JEV API 价格对比,JEV 决策模型价格 API 也讲同类决策端点。

常见问题
Mercury Decide 429 一直重试还是失败怎么办?
先看错误体区分来源:带 X-RateLimit-* 头是平台限额,带 provider_code 是上游限流。平台限额就降低请求频率或换付费变体,provider 限流就加 fallback models 或放宽路由偏好。
429 和 402 有什么区别?
429 是限流,瞬态,等 Retry-After 或退避重试即可恢复。402 是余额或 in-flight 预算不足,重试不会自己好,需要充值或减小请求体。
免费端点被限流了,怎么提高额度?
免费模型有每分钟和每日请求上限,购买 credits 可提高每日上限,或改用付费变体(官方文档明确付费变体没有平台级请求上限)。
流式输出中途收到 429 是什么情况?
流式请求在 provider 接受请求后,HTTP 状态已经发出,中途限流会以 SSE error 事件到达,finish_reason 为 error。此时按 429 处理,下次降低并发或错峰。
429 会不会影响零数据留存?
不会。零数据留存指请求和响应内容不被持久化,限流是访问控制层面的,两者互不影响。但建议固定支持零留存的 provider 路由,保证每次调用都走零留存链路。

京ICP备2024094994号-29