接入指南
故障排查
结合错误正文，按地址、认证、模型和额度逐项检查。
| 现象 | 先检查什么 |
|---|---|
| 400 / 参数错误 | JSON 格式、协议和额外参数；从最小请求开始 |
| 401 / 认证失败 | 密钥是否完整、有效，客户端是否仍读取旧变量 |
| 403 / 无权限 | 账户、分组、模型或 IP 限制，以及错误正文 |
| 404 | 完整路径、重复 /v1、模型 ID；不要填写 /dashboard |
| 无可用渠道 / 模型 | 该模型是否已开放，令牌分组和模型限制是否匹配 |
| 额度不足 / 已过期 | 账户余额、令牌额度及有效期分别检查 |
| 429 | 降低并发，按照响应提示等待，限制自动重试 |
| 5xx / 服务异常 | 保留请求编号与时间；持续发生时反馈 |
| 超时 / 流式断开 | 网络、客户端超时与服务状态；重发前查看扣费 |
| 返回 HTML 网页 | 是否请求了网页路由、命中人机验证或中间代理页面 |
最小请求成功，客户端失败
对照实际使用的协议、路径、默认模型和附加参数。若仅工具、图片或多轮失败，单独保留该功能的错误，不把最小文本调用成功当成全部兼容。
提交排查信息
提供时间与时区、客户端及版本、接口路径、模型 ID、分组、HTTP 状态码、错误正文和请求编号。删除 Authorization、API Key、密码、验证码和私人提示词后再分享。