调用智谱AI 开放平台 API 时,接收到的响应码由两部分组成:外层是 HTTP 状态码,内层是响应体正文中的定义的业务错误码,提供了更具体的错误描述。

HTTP 状态错误码

状态码原因解决方法
200业务处理成功-
400参数错误检查接口参数是否正确
400文件内容异常检查 jsonl 文件内容是否符合要求
401鉴权失败或 Token 超时确认 API KEY 和鉴权 token 是否正确生成
404微调功能未开放联系客服以开通此功能
404微调任务不存在确保微调任务 ID 正确
429接口请求并发超额调整请求频率或联系商务扩大并发数
429上传文件频率过快短暂等待后重新请求
429账户余额已用完进行账户充值以确保余额充足
429账户异常账户存违规行为,请联系平台客服或service@zhipuai.cn解除相关锁定
429终端账号异常终端用户存在违规行为,账号已被锁定
434暂无 API 权限,微调 API 及文件管理 API 为内测阶段,我们会尽快开放等待接口正式开放或请联系平台客服申请内测
435文件大小超过 100MB使用小于 100MB 的 jsonl 文件或分批上传
500服务器处理请求时发生错误稍后重试或联系客服

业务错误码

错误分类错误码错误信息
基础错误500内部错误
身份验证错误1000身份验证失败
1001Header 中未收到 Authentication 参数,无法进行身份验证
1002Authentication Token 非法,请确认 Authentication Token 正确传递
1003Authentication Token 已过期,请重新生成/获取
1004通过 Authentication Token 的验证失败
1100账户读写
账户错误1110您的账户当前处于非活动状态。请检查账户信息
1111您的账户不存在
1112您的账户已被锁定,请联系客服解锁
1113您的账户已欠费,请充值后重试
1120无法成功访问您的账户,请稍后重试
API 调用错误1200API 调用错误
1210API 调用参数有误,请检查文档
1211模型不存在,请检查模型代码
1212当前模型不支持 ${method} 调用方式
1213未正常接收到 ${field} 参数
1214${field} 参数非法。请检查文档
1215${field1}${field2} 不能同时设置,请检查文档
1220您无权访问 ${API_name}
1221API ${API_name} 已下线
1222API ${API_name} 不存在
1230API 调用流程出错
1231您已有请求:${request_id}
1234网络错误,错误id:${error_id},请联系客服
API 策略阻止错误1300API 调用被策略阻止
1301系统检测到输入或生成内容可能包含不安全或敏感内容,请您避免输入易产生敏感内容的提示语,感谢您的配合
1302您当前使用该 API 的并发数过高,请降低并发,或联系客服增加限额
1303您当前使用该 API 的频率过高,请降低频率,或联系客服增加限额
1304该 API 已达今日调用次数限额,如有更多需求,请联系客服购买

错误响应示例

以下是 curl 请求的响应报文,其中 401 是 HTTP 状态码,1002 是业务错误码。
* We are completely uploaded and fine
< HTTP/2 401
< date: Wed, 20 Mar 2024 03:06:05 GMT
< content-type: application/json
< set-cookie: acw_tc=76b20****a0e42;path=/;HttpOnly;Max-Age=1800
< server: nginx/1.21.6
< vary: Origin
< vary: Access-Control-Request-Method
< vary: Access-Control-Request-Headers
<
* Connection #0 to host open.bigmodel.cn left intact
{"error":{"code":"1002","message":"Authorization Token非法,请确认Authorization Token正确传递。"}}
注: 使用流式(SSE)调用时,如果 API 在推理过程中异常终止,不会返回上述错误码,而是在响应体的 finish_reason 参数中返回异常原因,详情请参考 finish_reason 的参数说明。