API 错误排查
API 返回 429 怎么排查
429 表示请求在当前时间被限流或额度规则拒绝。先降低并发和重试频率，再检查余额、套餐次数、分组限制和客户端自动重试。
429 不一定是服务故障
429 可能来自单 Key 并发、账号池额度、套餐次数、模型限流或短时间内的重复重试。不同原因都返回 429 时，要结合响应信息、请求时间和控制台用量判断。
五步排查法
- 暂停自动重试，等待一段时间后只发送一条短请求。
- 在 模型广场确认当前模型和分组。
- 在控制台检查余额、次数套餐有效期和 Key 是否设置了限制。
- 降低并发，将重试改为指数退避，并给每次重试设置上限。
- 换用分组允许的其他模型做一次对照测试，不要并行轰炸多个模型。
客户端重试应该怎么做
只对明确的临时限流重试；使用指数退避和随机抖动，并设置最大次数。流式请求已经产生部分内容时，不要无条件重放可能产生副作用的工具调用。
第 1 次：等待 1 秒
第 2 次：等待 2 秒
第 3 次：等待 4 秒
达到上限：记录请求 ID，交给用户或支持处理保留哪些信息
记录脱敏后的时间、模型 ID、并发量、客户端、HTTP 状态码和请求 ID。不要发送完整 Key、Prompt、文件或 Authorization 头。若持续 429，通过 控制台工单确认当前规则。
参考与下一步
本文只说明接入思路，实际模型、地址、权限和价格以 VC API 控制台当前配置为准。不要把 API Key 粘贴到公开内容中。