搜索
K
首页
Chat 站
Tokens 站
控制台
更新日志
简体中文
简体中文
English
主题
语言
简体中文
简体中文
English
菜单
目录
#
错误码清单
网关返回的全部状态码、对应场景与处理方式。按症状快速定位请先看
故障排查
。
#
认证类(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. 保留所有权利。
服务条款
隐私政策
免责声明