疑难排查 · Zed
Zed 助手 429 rate_limit_error 解决方法
Zed 助手中的 429 是你密钥背后账户的速率或并发上限。为什么代理线程和共用密钥会触发它,以及怎样解除。
你看到的报错
HTTP 429
{"error":{"message":"Rate limit reached. Please retry shortly.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}为什么会发生
- 密钥所属账户的速率或并发上限被超出——代理线程会接连发送多个请求。
- 同一把密钥同时被其他工具使用,它们的流量共享同一个上限。
- 在已饱和的窗口内重试,会让窗口一直饱和。
如何解决
- 等待 Retry-After 给出的间隔后继续——单个 429 不需要改任何配置。
- 在同一把密钥上同时运行更少的助手线程。
- 长时间运行期间,暂停共用这把密钥的其他工具。
相关搜索
zed assistant 429
常见问题
这是 Zed 的限制还是我密钥的限制?+
是密钥的。Zed 不添加自己的计量;429 来自所配置密钥背后的账户。
为什么代理线程会让情况更糟?+
代理线程每一步都会发送一个请求,而且常常一个接一个。即使你看到的问题很短,请求速率也会随着工作量增长。
立即重试有用吗?+
没用——立即重试会让窗口一直饱和;短暂停顿才能解除。