帮助
故障排查
本页内容
先检查 API 地址、协议、密钥分组和完整模型 ID,再根据实际错误信息处理。相同状态码可能有不同原因,应结合响应正文判断。
按错误定位
| 现象或状态码 | 优先检查 | 下一步 |
|---|---|---|
| 400 / 参数错误 | 请求 JSON、模型支持的参数、协议 | 用最小示例去掉额外参数再试 |
| 401 / 认证失败 | 密钥是否完整、是否失效、认证头是否正确 | 从控制台重新复制,检查客户端是否仍读取旧配置 |
| 403 / 无权限 | 密钥分组、访问 IP 限制、账户或订阅权限 | 查看密钥设置与错误正文,确认资格 |
| 404 / 路径或模型不存在 | 域名、重复 /v1、接口路径、模型 ID |
对照地址表,从该密钥目录复制模型 |
| 余额不足 / 额度不足 / 已过期 | 账户余额、密钥额度、有效期、订阅状态 | 补充余额或调整相应限制;充值不能自动解除所有限制 |
| 429 / 请求过多 | 并发、速率限制、上游容量 | 降低并发,按响应提示等待,有限次数重试 |
| 5xx / 上游错误 | 临时服务异常、分组通道状态 | 稍后重试;持续发生时保留请求信息反馈 |
| 超时 / 流式中断 | 网络、代理、客户端超时、上游处理时间 | 先核对使用记录,再判断是否重新提交 |
| 返回网页 HTML 而非 API 响应 | 是否使用控制台域名、代理拦截或错误路径 | 使用 api.supergpt.win 和正确接口路径 |
模型能看到,却不能调用
模型广场是站点展示目录。打开实际使用的那把密钥,核对分组中的模型与接入协议。专属或订阅分组还需要对应权限。
不要用另一个分组的模型列表判断当前密钥能否使用。模型 ID 需完整复制,注意版本后缀、大小写及额外空格。
客户端测试失败,但 curl 可以
通常需要检查客户端的协议选择、自动追加的路径、默认模型及额外参数。将配置缩减到 API 地址、密钥、模型三项,先完成一次简单文本请求。
如果只在多轮对话、图片或工具调用中失败,保留该功能的错误信息,确认模型和分组支持情况后再启用。
充值未到账
按充值指南核对链上交易、网络和实际到账数量,尤其是交易所扣除手续费后的金额与四位小数。提供订单号和 TxID 核验,不要重复付款。
反馈时提供这些信息
发生时间与时区:
客户端名称和版本:
协议 / 接口路径:
模型 ID 与分组:
HTTP 状态码和错误正文:
请求编号(如有):
是否能稳定复现:
分享前移除 API Key、密码、验证码和私人请求内容。公告与联系渠道见 Telegram 频道。