常见错误与 429
遇到错误先查看 HTTP 状态、返回的 error.message、error.code 和请求编号。相同状态码可能来自不同环节，仅凭数字不能确认根因。
常见状态
| 状态 | 可能原因 | 建议 |
|---|---|---|
| 400 | 请求字段、格式或功能未开放 | 对照本站文本示例，删掉客户端自动添加的工具、文件及媒体字段 |
| 401 | 密钥缺失、失效或不正确 | 检查 Bearer 格式和本站密钥，不用网页登录密码调用模型 |
| 403 | 权限、使用规则拒绝或凭据暂封 | 阅读具体提示，停止重复提交禁止内容；暂封时等待恢复 |
| 413 | 请求过大 | 缩短对话历史与文本，当前请求体上限为 1 MiB |
| 429 | 并发、频率或上游限额 | 先等待，按具体错误内容判断，不无限重试 |
| 500 / 502 / 503 | 服务或上游暂不可用、完整响应未取得 | 保留请求编号与时间，稍后有限重试 |
余额不足、模型不可用、价格未配置等业务错误也要读取返回正文，不能只看状态码或前端弹窗。
429 不一定是你“请求太多”
429 表示某一层限制了请求。当前每个凭据最多同时进行 2 个请求，模型调用频率限制为 每分钟 60 次；上游还有自己的资源与用量限制。
concurrency_limit：等待已有请求完成，再发下一个。流式请求在结束前仍占用并发。- 普通频率限制或上游 429：尊重
Retry-After（若有），采用有限次数、逐步延长等待的重试，避免立即重复请求。 - 页面直接显示 HTTP ERROR 429：浏览器页面请求也可能受限制；稍等再刷新，持续发生时保留发生时间和路径给管理员。
正常文本问题遭误判时，可提供请求编号和必要的非敏感说明供复核；不要发送可用密钥、密码或完整敏感原文。
403 与凭据暂封
content_policy_violation 表示本次请求命中本站使用限制，已在发送上游前拒绝。
account_risk_suspended 返回 403：异步审核已确认会话违规并暂停整个账户，全部密钥停止使用。请查看原因与样本编号，向 wsygxb@qq.com 提供请求编号申请人工复核；不要更换密钥继续尝试。
repeated_request_limit 返回 429 并提供等待提示：重复或异常请求受到限制。请检查客户端自动重试或循环错误，停止持续重发，按返回提示稍后重试。
接口地址和模型问题
Base URL 应为 https://api.baiyun.si/v1，完整 Chat 地址为 /v1/chat/completions，Responses 地址为 /v1/responses。检查是否出现重复 /v1/v1，以及客户端是否选择了本站未开放的协议。
模型名称必须与模型广场及当前密钥的 /v1/models 返回一致，不要用客户端的显示别名代替真正的调用名称。
流式和费用问题
Chat SSE 应读取到 [DONE]；Responses SSE 应读取完整结束事件。网络断线后的部分文本不能当作完整成功响应。
输入输出参数并不保证费用硬上限。正常请求、进入上游后的失败或客户端取消，需结合实际消费记录核对；只有在本地拒绝且未进入上游的请求不产生本次模型调用扣费。
排查时提供什么
- 发生时间与时区。
- 请求编号、模型名称、接口路径及 HTTP 状态。
- 去掉密钥和敏感内容后的错误信息。
- 支付问题另外提供订单号与状态，不提供支付商户密钥。
本站仍在逐步完善，暂未承诺全天候人工响应或固定处理时限。