错误码、鉴权、限流、暂封、接口与费用问题的排查方法。 附完整检查步骤、实操验证和错误处理。

常见错误与 429

遇到错误先查看 HTTP 状态、返回的 error.message、error.code 和请求编号。相同状态码可能来自不同环节，仅凭数字不能确认根因。

常见状态

余额不足、模型不可用、价格未配置等业务错误也要读取返回正文，不能只看状态码或前端弹窗。

429 不一定是你“请求太多”

429 表示某一层限制了请求。当前每个凭据最多同时进行 2 个请求，模型调用频率限制为 每分钟 60 次；上游还有自己的资源与用量限制。

• concurrency_limit：等待已有请求完成，再发下一个。流式请求在结束前仍占用并发。
• 普通频率限制或上游 429：尊重 Retry-After（若有），采用有限次数、逐步延长等待的重试，避免立即重复请求。
• 页面直接显示 HTTP ERROR 429：浏览器页面请求也可能受限制；稍等再刷新，持续发生时保留发生时间和路径给管理员。

正常文本问题遭误判时，可提供请求编号和必要的非敏感说明供复核；不要发送可用密钥、密码或完整敏感原文。

403 与凭据暂封

content_policy_violation 表示本次请求命中本站使用限制，已在发送上游前拒绝。

credential_temporarily_blocked 返回 403，并提供 Retry-After 等待提示：同一凭据在 30 分钟内多次命中使用规则后，暂停 30 分钟。请停止相关内容并等待恢复，不通过更换密钥继续尝试。这与 429 并发或频率限制是不同原因。

接口地址和模型问题

Base URL 应为 https://api.baiyun.si/v1，完整 Chat 地址为 /v1/chat/completions，Responses 地址为 /v1/responses。检查是否出现重复 /v1/v1，以及客户端是否选择了本站未开放的协议。

模型名称必须与模型广场及当前密钥的 /v1/models 返回一致，不要用客户端的显示别名代替真正的调用名称。

流式和费用问题

Chat SSE 应读取到 [DONE]；Responses SSE 应读取完整结束事件。网络断线后的部分文本不能当作完整成功响应。

输入输出参数并不保证费用硬上限。正常请求、进入上游后的失败或客户端取消，需结合实际消费记录核对；只有在本地拒绝且未进入上游的请求不产生本次模型调用扣费。

排查时提供什么

1. 发生时间与时区。
2. 请求编号、模型名称、接口路径及 HTTP 状态。
3. 去掉密钥和敏感内容后的错误信息。
4. 支付问题另外提供订单号与状态，不提供支付商户密钥。

本站仍在逐步完善，暂未承诺全天候人工响应或固定处理时限。

实操前的检查清单

1. 准备自己的账户与调用密钥，不使用他人的共享凭据。
2. 记录客户端版本、系统和准备使用的模型，便于排查时复现。
3. 保存原配置或截图，隐藏密钥、验证码与私人内容。
4. 确认测试可能消费少量 DK，先用一句话、一次请求开始。
5. 查阅当前模型广场与状态页，再决定是否启用更多功能。

详细排查：按顺序缩小问题范围

先确认账户已完善、密钥有效、DK 余额足够，再核对协议、地址与模型。用同一密钥做一次最小文本请求；它成功以后，才逐项恢复附件、工具或自动重试。客户端配置保存后重新打开会话，避免旧会话仍使用先前供应商。

怎样确认本节已经学会

不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。

如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。

一个适合练习的小任务

在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。

下一步与版本边界

返回完整学习地图 · API 站精简配置 · 本站实时状态。

教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。