• 简体中文
  • 错误码对照与排查

    调用 API 出错时,先根据 HTTP 状态码定位类别,再按「解决办法」操作。错误响应体为 JSON,error.message 中有具体原因。

    错误码速查表

    HTTP 状态码含义常见原因解决办法
    400 Bad Request请求参数错误JSON 格式错误、缺少 model / messages、字段类型不对用 JSON 校验工具检查请求体;对照 能力调用 的字段表修正
    401 Unauthorized令牌无效或未传没带 Authorization 头、令牌填错 / 带空格换行、令牌已删除检查请求头格式 Authorization: Bearer sk-你的令牌;到 API 密钥页 确认令牌存在并复制完整值
    403 Forbidden无权限令牌已被禁用、令牌设置了模型范围或 IP 白名单、账号被封禁在 API 密钥页 启用令牌、检查「高级设置」中的模型限制与 IP 白名单;仍不行见 联系我们
    404 Not Found模型或路径不存在模型名拼写错误、大小写不符、该模型不在你的分组到 模型广场 复制准确模型名;确认 API 地址路径正确(见 接入地址)
    429 Too Many Requests触发速率限制短时间请求过多,超过 RPM / TPM 限制降低请求频率、加指数退避重试;持续受限请通过 联系我们 反馈
    5xx Server Error服务端异常上游服务波动或网关内部错误稍等 1~2 分钟后重试;持续出现请反馈给我们(联系方式见 联系我们)

    平台特有错误

    错误文案含义解决办法
    余额不足 / insufficient quota账户余额为 0到 充值平台 充值后重试
    令牌额度已用尽 / token quota used up令牌自身的额度上限用完(账户余额仍充足)到 API 密钥页 编辑该令牌,调高额度或开启无限配额
    令牌已过期 / token expired令牌到达过期时间编辑令牌延长有效期,或新建一个令牌
    无可用渠道 / no available channel该模型当前无可用线路稍后重试;长时间不可用请通过 联系我们 反馈
    NOTE

    「余额充足仍报余额不足」九成是令牌层面的限制(额度、过期时间),而不是账户余额——两回事。排查顺序:账户余额(钱包)→ 令牌额度与过期时间(API 密钥)→ 令牌模型范围。

    排查通用三步

    遇到任何报错,先过一遍这三步,能解决大部分问题:

    1. 地址对吗? base_url 是 https://api-model.shuntianchuang.cn/v1,完整端点见 接入地址与鉴权。
    2. 密钥对吗? 令牌完整无空格、状态为已启用,见 API Key 管理。
    3. 模型名对吗? 从 模型广场 复制,注意大小写(本站同时存在 qwen-plus 与 Qwen-plus 等不同模型)。

    排查后仍无法解决时,通过 联系我们 中的联系方式反馈,附上:时间、模型名、状态码、error.message 内容(注意隐去令牌)。