错误排查
先定位问题类型，再处理具体配置
大多数接入失败都可以先从状态码判断方向。第一次排查时，不要同时改很多配置，先确认 API Key、模型 ID、余额和请求地址。
如果错误里带有 request_id，请保留它，联系我们时一并提供，方便定位问题。
常见问题先查这里
401
认证失败
优先检查 Authorization 是否是 Bearer sk-xxxx 格式，API Key 是否复制完整，以及当前 Key 是否仍然有效。
404
模型不存在
优先检查 model 字段是否填写了真实可用的模型 ID。不要只填写厂商名、能力标签或示例占位符。
402
额度不足
检查账户余额、Token 额度限制、赠送次数是否已耗尽，以及当前请求是否超出可用额度。
429
请求太频繁
降低并发或请求频率，必要时调整调用节奏。不要把重试写成无限循环。
按你遇到的问题排查
提示认证失败、无权限或 401，先看什么？
先确认请求头是 Authorization: Bearer sk-xxxx，Bearer 和密钥中间有空格；再确认密钥没有少复制字符、没有过期，并且当前工具确实把这个 Key 传给了 WEI HUB。
提示模型不存在、找不到模型或 404，怎么处理？
先检查 model 字段是不是平台真实可用的模型 ID。不要填写厂商名、能力分类或文档里的 YOUR_MODEL_ID 占位符。如果 Token 做了模型权限限制，也要确认该 Token 被授权访问这个模型。
提示余额不足、额度不足或 402，应该检查哪里？
检查账户余额、Token 额度上限、赠送次数是否已经用完，以及当前请求是否触发了更高成本的模型或多模态能力。必要时先用一个低成本文本模型做连通性测试。
请求太频繁或 429，是否应该一直重试？
不要无限重试。先降低并发和请求频率，为重试加上最大次数与退避间隔。如果是批量任务，建议拆分队列并记录失败请求，避免短时间重复冲击同一个模型。
| HTTP | 错误类型 | 说明 |
|---|---|---|
| 400 | invalid_request_error | 请求参数错误或缺少必填字段。 |
| 401 | authentication_error | Token 无效、缺失或过期。 |
| 402 | insufficient_quota | 余额不足，或可赠送次数已耗尽且无法继续扣费。 |
| 404 | model_not_found | 模型不存在，或当前没有可用绑定渠道。 |
| 429 | rate_limit_error | 请求频率超限。 |
| 500 | server_error | 平台内部错误，请与我们联系。 |