错误码

更新时间：2025-01-10

错误码说明

本文主要介绍推理服务API对应的错误码及其错误描述。在调用API请求后，可以通过返回的错误码、错误信息及排查建议等进行问题排查。如果遇到限流或服务不稳定等问题，可以先尝试查看调用频率限制解决方案处理。

错误码格式

若请求错误，服务器将以JSON格式返回错误信息，错误信息包含：

参数名	说明
error_code	错误码
error_msg	错误描述信息，帮助理解和解决发生的错误。

例如Access Token失效返回：

{
  "error_code": 110,
  "error_msg": "Access token invalid or no longer valid"
}

错误码列表

大模型能力相关

错误码	错误信息	说明及排查建议
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介绍
200	InternalError	服务错误，模板不存在。
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	请求不能为空
336007	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字段，并且长度超过了模型的限制
336120	tokenizer interanl error	tokenizer服务内部错误
336121	unknown tokenizer	未知的tokenizer类型
336122	tokenizer input prompt too long	tokenizer输入字符过长
336123	unknown model name	未知的模型入参
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中会给出具体的说明
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	图生文输入图审不安全
336311	invalid image	输入图片图生文模型无法接受
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有限流/重试机制等避免一些问题，请查看错误缓解方案 · 如果仍未解决，请在百度云控制台内提交工单反馈
336507	Rate limit reached for Cluster TPM	集群TPM超限额，请在百度云控制台内提交工单反馈。
337006	缺少必要参数	* 【用户输入错误】未找到llm相关参数->插件应用模型AK/SK无效，无法获取access_token * 【用户输入错误】未找到工具相关参数->缺少插件相关参数或参数配置不正确。
337008	插件id输入错误	一般指插件id输入错误，如插件id超过3个可能会引起此错误
337009	插件请求错误	请参考error_msg信息和信息中的错误码进行排查。

IAM认证相关

基于百度智能云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.	所有未定义的其他错误。

服务域名

错误缓解方案