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

错误码表格

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服务器处理请求时发生错误稍后重试或联系客服

错误示例

以下是 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正确传递。"}}

业务错误码

错误分类错误码错误信息
基础错误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 已达今日调用次数限额,如有更多需求,请联系客服购买
注: 使用流式(SSE)调用时,如果 API 在推理过程中异常终止,不会返回上述错误码,而是在响应体的 finish_reason 参数中返回异常原因,详情请参考 finish_reason 的参数说明。