401、403：鉴权与权限
检查 Authorization 格式、密钥是否包含空格、是否被禁用，以及当前密钥是否有目标模型权限。不要把完整密钥贴到工单或公开讨论。
404：路径或模型不存在
打印最终请求 URL，检查 Base URL 是否重复拼接。模型不存在时，从模型广场复制当前标识，注意营销名称与 API 模型名可能不同。
429、5xx 与重试
429 可能来自速率限制或额度不足，应降低并发并查看账户状态。网络错误和部分 5xx 可使用带随机抖动的指数退避，但必须限制次数。
第 1 次重试：约 1 秒后
第 2 次重试：约 2 秒后
第 3 次重试：约 4 秒后
超过上限：记录请求标识并返回明确错误常见问题
关于AI API 401、404、429 与 5xx 错误排查的常见问题
401 是否应该重试？
不应该自动重试，应先修复密钥或鉴权格式。
429 一定是请求太快吗？
不一定，也可能是额度或渠道限制，应结合错误信息和控制台判断。
所有 5xx 都能重试吗？
只能有限重试，并考虑请求是否可能已经执行和产生费用。