错误码
更新时间：2025-08-04
错误码说明
本文主要介绍推理服务API对应的错误码及其错误描述。在调用API请求后，可以通过返回的错误码、错误信息及排查建议等进行问题排查。如果遇到限流或服务不稳定等问题，可以先尝试查看调用频率限制解决方案处理。
错误码格式
若请求错误，服务器将以JSON格式返回错误信息，错误信息包含：
| 参数名 | 说明 |
|---|---|
| error_code | 错误码 |
| error_msg | 错误描述信息，帮助理解和解决发生的错误。 |
例如Access Token失效返回：
JSON
1{
2 "error_code": 110,
3 "error_msg": "Access token invalid or no longer valid"
4}错误码列表
大模型能力相关
| 错误码 | 错误信息 | 说明及排查建议 |
| 1 | Unknown error | 【系统内部错误】服务器内部错误，请再次请求， 如果持续出现此类错误，请在百度云控制台内提交工单反馈。 |
| 2 | Service temporarily unavailable | 【系统内部错误】服务暂不可用，请再次请求， 如果持续出现此类错误，请在百度云控制台内提交工单反馈。 |
| 3 | Unsupported openapi method | 【用户输入错误】调用的API不存在，请检查后重新尝试。 |
| 4 | Open api request limit reached | 【系统内部错误】集群超限额，请再次请求，如果持续出现此类错误，请在百度云控制台内提交工单反馈。 |
| 6 | No permission to access data | 【鉴权错误】app无权限访问服务。 定制服务：检查定制服务是否处于【已发布】状态，定制服务发布成功以后会自动授权。 插件服务：请为在应用接入为应用配置插件服务的权限。 |
| 13 | Get service token failed | 【鉴权错误】获取token失败。 |
| 14? | IAM Certification failed | 【鉴权错误】IAM鉴权失败。 |
| 15? | app not exists or create failed | 应用不存在或者创建失败。 重试调用可解决问题。 |
| 17 | Open api daily request limit reached | 【用户配额超限】如果是付费接口，可能是付费接口未开通付费，或者当前账户已欠费，请检查账户余额。如果是免费接口，免费接口每天请求量超限额。 |
| 18 | Open api qps request limit reached | 【用户配额超限】QPS超限额，可以尝试通过以下方法解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果仍未解决，请在百度云控制台内提交工单反馈 |
| 19? | Open api total request limit reached? | 免费接口，请求总量超限额 |
| 100? | Invalid parameter | 【鉴权错误】无效的access_token参数，请检查后重新尝试。 |
| 110 | Access token invalid or no longer valid | 【鉴权错误】access_token无效。 |
| 111 | Access token expired | 【鉴权错误】access token过期，默认有效期30天，尝试通过以下方法解决： · 重新获取access_token，通过调用获取access_token接口获取 · 通过使用SDK调用API，SDK会自动刷新，以确保access_token不过期，如何调用SDK可以查看SDK介绍 |
| 336000 | Internal error | 【系统内部错误】服务内部错误，请稍后重试。 |
| 336001 | Invalid Argument | 【用户输入错误】入参格式有误，比如缺少必要参数。 |
| 336002 | Invalid JSON | 【用户输入错误】入参body不是标准的JSON格式。 |
| 336003 | field system too long | 【用户输入错误】字段system长度过长。 |
| message content can not be empty | 【用户输入错误】入参中content的值不能为空。 | |
| parameter check failed, temperature range is (0, 1.0] | 【用户输入错误】入参错误，temperature的范围是(0-1.0]。 | |
| parameter check failed, top_p range is [0, 1.0] | 【用户输入错误】入参错误，top_p的范围是[0-1.0]。 | |
| parameter check failed, penalty_score range is [1.0, 2.0] | 【用户输入错误】入参错误，penalty_score 的范围是[1.0-2.0]。 | |
| The Name field cannot be empty if the role field is function | 【用户输入错误】如果role为function，则name不能为空。 | |
| function_call's name can't be blank | 【用户输入错误】function_call的name不能为空。 | |
| functions name can't be blank | 【用户输入错误】functions的name不能为空。 | |
| functions description can't be blank | 【用户输入错误】functions的description不能为空。 | |
| functions parameters can't be blank | 【用户输入错误】functions的parameters不能为空。 | |
| prompt len invalid, len xxx | 【用户输入错误】prompt无效，当前输入长度... | |
| the content of current query can not be blank | 当前query的内容不能为"\n", "\r"等空白字符 | |
| embeddings max input length is 16 | 【用户输入错误】请检查参数input文本数量，不能超过16 | |
| prompt tokens too long | 【用户输入错误】请求内容超过大模型内部限制 | |
| 其他情况，请查看返回的具体说明 | 用户输入参数错误，error_msg中会给出具体的说明 | |
| 336004 | appid:xxx have not enable trace permission | 权限控制出错。 |
| 336005 | API name not exist | 【用户输入错误】定制化模型服务apiname不存在。 |
| 336006 | the length of messages must be an odd number | 【用户输入错误】messages数组长度必须为奇数。 |
| the role of message with even index in the messages must be user or function | 【用户输入错误】message入参列表中，索引为偶数的role的值必须是“user”或者“function” | |
| the role of message with odd index in the messages must be assistant | 【用户输入错误】message入参列表中，索引为奇数的role的值必须是“assistant” | |
| 336007 | prompt can not be empty | 请求不能为空 |
| the max input characters is xxx | 请求长度不能超过最大字符限制，即用户输入大模型内容过长，可以尝试以下方法解决： · 适当缩短输入 · 也可以通过千帆SDK调用避免此问题，当输入内容过长时，SDK会自动截断输入 |
|
| 336008 | functioncall相关参数用户输入错误的具体说明 | functioncall功能用户输入错误，如total size cannot larger then xxx，表示总长度不能超过xxx个字符 |
| 336100 | Internal error | 【系统内部错误】服务内部错误，请稍后重试。 |
| 336101 | Invalid HTTP Method | 【用户输入错误】非法的HTTP Method， 当前仅支持POST请求 |
| 336102 | user_id can not be empty | 【用户输入错误】user_id字段未设置 |
| 336103 | Prompt tokens too long | 【用户输入错误】请求内容超过大模型内部限制，即用户输入大模型内容过长，可以尝试以下方法解决： · 适当缩短输入 · 也可以通过SDK调用避免此问题，当输入内容过长时，SDK会自动截断输入 |
| 336104 | system is invalid | 【用户输入错误】system内容不合法 |
| 336105 | user is invalid | user_setting内容不合法 |
| 336106 | the content of functions field is invalid | function内容不合法 |
| 336110 | Plugin not exist | 插件不存在 |
| 336111 | Invalid plugin extra_data | 插件extra_data 反序列化失败 |
| 336112 | plugin extra_data too long | 插件plugin_header超出长度限制 |
| 336113 | 由插件开发者自己定义，千帆ModelBuilder透传错误描述 | 插件服务用户输入错误 |
| 336114 | plugin unsupported | 插件未对千帆ModelBuilder开放 |
| 336115 | unsupported authentication type | 插件鉴权类型不支持 |
| 336116 | number of plugins exceed 3 | 插件超过预定数量 |
| 336117 | plugin system request limit reached | 插件系统承载不足 |
| 336118 | prompt tokens too long | 【用户输入错误】用户输入中传递了plugins字段或者functions字段，并且长度超过了模型的限制 |
| 336119 | plugins not match plugin_options.plugin_args long | 用户传入的plugin和plugin_args不匹配 |
| 336120 | tokenizer interanl error | tokenizer服务内部错误 |
| 336121 | unknown tokenizer | 未知的tokenizer类型 |
| 336122 | tokenizer input prompt too long | tokenizer输入字符过长 |
| 336123 | unknown model name | 未知的模型入参 |
| 336130 | parameter check failed, prompt tokens exceeds model params range | prompt tokens超过模型服务启动参数限制 |
| 336131 | parameter check failed, max_output_tokens exceeds model params range | max_output_tokens超过模型服务启动参数 |
| 336132 | Invalid Atom API list | 虚拟API的原子API列表无效 |
| 336200 | Embeddings internal error | 【系统内部错误】Embeddings服务内部错误 |
| 336210 | PromptOpt internal error | Prompt优化服务内部错误 |
| 336211 | PromptOpt input illegal | Prompt优化服务输入内容不合法 |
| 336212 | PromptOpt output illegal | Prompt优化服务输出内容不合法 |
| 336220 | Reranker internal error | Reranker服务内部错误 |
| 336221 | Reranker接口用户输入错误的具体说明 | 用户输入参数错误，error_msg中会给出具体的说明 |
| 336230 | Parser internal error | Parser接口内部错误 |
| 336231 | Parser request invalid | 用户输入参数错误，error_msg中会给出具体的说明 |
| 336300 | inner error | 文生图内部错误 |
| 336301 | text2image service is busy，please control request concurrency | 文生图服务超时 |
| 336302 | Text2Image input illegal | 文生图输入文审不安全 |
| 336303 | Text2Image output illegal | 文生图输出图审不安全 |
| 336304 | Chinese translation error, please try again or change to English input | 文生图中文翻译失败 |
| 336310 | inner error | 图生文内部错误 |
| 336311 | image2text input image illegal | 图生文输入图审不安全 |
| invalid image | 输入图片图生文模型无法接受 | |
| 336312 | unable to retrieve the image via image_url | 图像多模态模型（LIteV）输入图片URL无法获取 |
| 336313 | open-source model image tokens and prompt tokens are too long | 图生文tokens超限 |
| 336400 | Safety extension internal error | 安全扩展接口内部错误 |
| 336501 | Rate limit reached for RPM | Cloud ID下RPM超限额，可以尝试以下方式解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果您需要提升更大的RPM/TPM配额，请在控制台上进行TPM/RPM配额的购买 · 如果仍未解决，请在百度云控制台内提交工单反馈 |
| 336502 | Rate limit reached for TPM | Cloud ID下TPM超限额，可以尝试以下方式解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果您需要提升更大的RPM/TPM配额，请在控制台上进行TPM/RPM配额的购买 · 如果仍未解决，请在百度云控制台内提交工单反馈。 |
| 336503 | Rate limit reached for scramble resource | 混抢资源qps超限，包含可抢占接口、离线推理、离线评估请求。 |
| 336504 | request limit by resouce cluster reached | 集群QPS超限额，请再次请求，如果持续出现此类错误，请在百度云控制台内提交工单反馈。 |
| 336505 | qps request limit by APP ID reached | 【用户配额超限】QPS超限额，可以尝试通过以下方法解决： · 适当控制请求频率，避免失败，请参考速率限制说明 · 通过调用SDK解决，SDK有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果仍未解决，请在百度云控制台内提交工单反馈 |
| 336506 | Rate limit reached for Cluster RPM | 集群 RPM超限额，请在百度云控制台内提交工单反馈。 |
| 336507 | Rate limit reached for Cluster TPM | 集群TPM超限额，请在百度云控制台内提交工单反馈。 |
| 336508 | Rate limit reached for offline batch reasoning | 离线批量预测超限 |
| 336700 | Invalid Argument | tools/tool_choice 缺少必要参数 |
| Unsupported tool type | tools 类型不支持 | |
| Chosen tool not found | tools 候选的工具列表不支持 | |
| Invalid tool_choice type | tool_choice中的type的取值不支持 | |
| Invalid argument for baidu_search tool | tools baidu_search相关的参数校验错误 | |
| Input message too long for baidu_search tool | 调用工具 query过长 | |
| The value of top_n must an integer from 1 to 5 | 调用 baidu_search参数中top_n取值为1~5的整数 | |
| Unsupported channel value | 调用 baidu_search参数中channel取值不支持 |
IAM认证相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
| 400 | InappropriateJSON | The JSON you provided was well-formed and valid, but not appropriate for this operation. | 请求中的JSON格式正确，但语义上不符合要求。如缺少某个必需项，或值类型不匹配等。 |
| 400 | InvalidMarker | The marker you provided was invalid. | 请求的marker不合法。 |
| 400 | SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. Check yourSecret Access Key and signing method. Consultthe service documentation for details. | Authorization头域中附带的签名和服务端验证不一致。 |
| 400 | RequestExpired | Request has expired. Timestamp date is . | 请求超时。要改成x-bce-date。若请求中只有Date，需将Date转成datetime。 |
| 400 | InvalidHTTPAuthHeader | The Access Key ID you provided does notexist in our records. | Authorization头域格式错误。 |
| 400 | InvalidHTTPRequest | There was an error in the body of your HTTP request. | HTTP body格式错误。例如不符合指定的Encoding等。 |
| 400 | InvalidURI | Could not parse the specified URI. | URI形式不正确。例如一些服务定义的关键词不匹配等。对于ID不匹配的问题，应定义更加具体的错误码，如NoSuchKey。 |
| 400 | MalformedJSON | The JSON you provided was not well-formed. | JSON格式不合法。 |
| 403 | AccessDenied | Access denied. | 无权限访问对应的资源。 |
| 403 | IdempotentParameterMismatch | The request uses the same client token asa previous, but non-identical request. | clientToken对应的API参数不一样。 |
| 403 | InvalidAccessKeyId | The Access Key ID you provided doesnot exist in our records. | Access Key ID不存在。 |
| 403 | OptInRequired | A subscription for the service is required. | 没有开通对应的服务。 |
| 404 | InvalidVersion | The API version specified was invalid. | URI的版本号不合法。 |
| 500 | InternalError | We encountered an internal error Please try again. | 所有未定义的其他错误。 |