• 简体中文
  • 错误码清单

    网关返回的全部状态码、对应场景与处理方式。按症状快速定位请先看故障排查

    认证类(401)

    场景说明处理
    密钥缺失请求没带认证头检查客户端是否正确注入密钥,认证方式见 API 端点
    密钥无效Key 不存在或格式错误API 密钥页面重新复制,注意首尾空格
    密钥禁用Key 被手动禁用,或团队 Key 被所有者禁用密钥页确认状态;团队 Key 被管理员锁定时需联系所有者
    密钥过期创建时设置的过期时间已到新建一个 Key

    额度与限流(402 / 429)

    场景说明处理
    余额不足订阅与余额均耗尽充值订阅页面充值或续订
    Key 额度耗尽该 Key 单独设置的额度上限已用完编辑 Key 调高上限,或新建
    团队限额超限成员的日/周/月任一档到顶等周期自动重置,或让所有者在团队页面调整
    并发超限(429)同时进行的请求数过多降低并发,排队重试
    速率限制(429)短时间请求过密加指数退避重试

    权限类(403)

    场景说明处理
    模型不在分组内请求的模型不属于 Key 绑定的分组模型广场确认分组的模型清单
    协议格式不匹配分组不接受该格式的请求换对应格式的分组,见核心概念
    分组限定客户端该分组只允许特定客户端换客户端或换分组,看分组说明标签
    能力未开放分组未开放该能力(如生图)换支持该能力的分组
    账号状态异常团队相关账号被停用或团队暂停团队页面确认

    请求类(400 / 404)

    场景说明处理
    复合 Key 前缀缺失模型 ID 没带前缀写成 前缀/模型ID,见复合 Key
    复合 Key 前缀无效前缀不在映射内或格式非法密钥页核对映射
    复合 Key 接口不支持Realtime 类接口不支持复合 Key换普通 Key
    请求体格式错误JSON 非法、必填字段缺失对照客户端或 SDK 文档修正
    端点不存在(404)路径写错、/v1 多写或少写对照 API 端点
    模型不存在(404)模型 ID 拼错拉一次模型列表,用返回的准确 ID

    上游类(5xx / 529)

    场景说明处理
    上游过载(529)模型厂商侧容量吃紧稍后重试;系统会自动冷却对应上游账号
    上游超时长推理响应慢客户端调大超时时间
    上游临时错误(502/503)厂商侧抖动网关会自动故障转移,稳定复现时走反馈
    网关内部错误(500)服务异常带请求 ID 按反馈模板提交

    读错误响应的技巧

    • 响应体里的 message 通常直接说明了缺什么、错在哪,先读完再排查;
    • 响应头里的请求 ID 是定位单笔请求的唯一凭据,反馈时务必带上;
    • 客户端有时会吞掉响应体只显示状态码,此时用 curl -i 重放一次拿完整信息。
    © 2026 ByteSeek Limited. 保留所有权利。服务条款隐私政策免责声明