帮助

故障排查

本页内容

先检查 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 频道。