豆包大语言模型API调用错误码一览表

本文介绍了您可能从 API 和官方 SDK 中看到的错误代码。

http code	说明
400	原因：错误的请求，例如缺少必要参数，或者参数不符合规范等 解决方法：检查请求后重试
401	原因：认证错误，代表服务无法对请求进行认证。签名缺失/API key解析失败/ak找不到等错误为认证错误 解决方法：检查相关认证信息后重试
402	原因：表示客户端必须付费才能访问所请求的资源 解决方法：开通相关服务
403	原因：权限错误，ak/sk、API key 没有对应 Endpoint 权限 解决方法：请检查 ak/sk、API key 后重试
404	原因：调用的接口不存在、不支持 解决方法：请检查请求后重试
429	原因：最大 QPM/TPM 触发限流保护 解决方法：调整您的请求或提升 QPM/TPM 限额
500	原因：服务遇到意外情况无法提供服务，如依赖的其他组件或网络错误 解决方法：短暂等待后重试您的请求，如果问题仍然存在请联系我们
503	原因：服务负载高 解决方法：请稍等片刻后重试

code	http code	message	描述
MissingParameter	400	The request failed because it is missing one or multiple required parameters.	请求缺少必要参数，请查阅API文档。
MissingParameter.{parameter}	400	The request failed because it is missing a required parameter: {parameter}	请求缺少必要参数: {parameter}，请查阅API文档。
InvalidParameter	400	One or more parameters specificed in the request are not valid.	请求包含非法参数，请查阅API文档。
InvalidParameter.{parameter}	400	A parameter specified in the request is not valid: {parameter}	请求参数非法: {parameter}, 请查阅API文档。
InvalidParameter .UnsupportedModel	400	The request failed because the selected model does not support the stream mode.	模型不支持流式接口，请使用非流式接口，或选择其它模型
InvalidParameter.OversizedImage	400	The request failed because the size of the input image exceeds the limit.	图片大小超出限制，请缩小图片后重试。
InvalidParameter.UnsupportedImageFormat	400	The request failed because the image format is not supported by the API.	图片格式不支持，请修改图片格式后重试。
InvalidParameter.UnsupportedImageCount	400	The request failed because more than one image was submitted in a single session.	一轮对话仅支持一张图片，请修改请求后重试。
InvalidParameter.UnsupportedInput	400	Only tos, http or https URLs are supported.	仅支持tos，http或https URL，请修改请求后重试
InvalidEndpoint	400	The request targeted an endpoint that does not exist or is invalid.	推理接入点不存在或者非法，请检查输入的推理接入点信息。
InvalidEndpoint.ClosedEndpoint	400	The request targeted an endpoint that is currently closed or temporarily unavailable.	推理接入点处于已被关闭或暂时不可用， 请稍后重试，或联系推理接入点管理员。
SensitiveContentDetected	400	The request failed because the input text may contain sensitive information.	输入文本可能包含敏感信息，请您稍后重试，或使用其他prompt。
AuthenticationError	401	The API key in the request is missing or invalid.	请求携带的api key校验未通过，请您重新检查设置的api key，或者查看API调用文档来排查问题。
AccountOverdueError	403	The request failed because your account has an overdue balance.	当前账号欠费，如需继续调用，请前往火山交易中心进行充值
AccessDenied	403	The request failed because you do not have access to the requested resource.	没有访问该资源的权限，请检查权限设置，或联系管理员添加白名单。
				RateLimitExceeded.FoundationModelTPMExceeded	429	The Tokens Per Minute (RPM) limit of the associated foundation model for your account has been exceeded.	请求所关联的基础模型已超过帐户 TPM (Tokens Per Minute) 限制, 请稍后重试。
RateLimitExceeded.EndpointRPMExceeded	429	The Requests Per Minute (RPM) limit of the associated endpoint for your account has been exceeded.	请求所关联的推理接入点已超过帐户 RPM (Requests Per Minute) 限制, 请稍后重试。
RateLimitExceeded.EndpointTPMExceeded	429	The Tokens Per Minute (RPM) limit of the associated endpoint for your account has been exceeded.	请求所关联的推理接入点已超过帐户 TPM (Tokens Per Minute) 限制, 请稍后重试。
QuotaExceeded	429	Your account [%s] has exhausted its free trial quota for the [%s] model.	当前账号 %s 对 %s 模型的免费试用额度已消耗完毕，如需继续调用，请前往火山方舟控制台开通管理页开通对应模型服务。
ModelLoadingError	429	The request cannot be processed at this time because the model is currently being loaded	模型加载中，请您稍后重试。
ServerOverloaded	429	The service is currently unable to handle additional requests due to server overload.	服务资源紧张，请您稍后重试
RequestCancelled	499	The request has been cancelled before it completed.	请求已被调用方取消，请您稍后再次请求。
InternalServiceError	500	The service encountered an unexpected internal error.	内部系统异常，请您稍后重试。

错误码

code	code_n	含义说明
ClientSDKRequestError	1709701	客户端请求错误 可能原因：请求参数无法解析；请求返回无法解析；请求超时；远程调用失败
SignatureDoesNotMatch	1709801	鉴权签名信息不匹配 可能原因：用错了ak/sk，或者是api使用方式有问题
RequestTimeout	1709802	请求超时 可能原因：超时时间设置过短，或者系统服务繁忙暂时无法及时响应
ServiceConnectionTimeout	1709803	服务连接超时 可能原因：后端系统服务繁忙，可以稍后重试
MissingAuthenticationHeader	1709804	缺少鉴权的header 可能原因：请求没有加入Authorization请求头
AuthenticationHeaderIsInvalid	1709805	鉴权信息无效 可能原因：Authorization内容被误修改；用错了ak/sk，或者是api使用方式有问题
InternalServiceError	1709806	系统服务异常 可能原因：系统内部服务异常
MissingParameter	1709807	缺少参数 可能原因：缺少相关必要请求字段
InvalidParameter	1709808	无效参数 可能原因：输入参数不符合输入规范
AuthenticationExpire	1709809	鉴权信息超时 可能原因：ak/sk超时，或者已经被标记为无法使用
EndpointIsInvalid	1709810	访问服务节点无效 可能原因：输入了无效的访问节点信息
EndpointIsNotEnable	1709811	访问服务节点已经无法访问 可能原因：该节点已被拥有者标记为无效
ModelNotSupportStreamMode	1709812	模型不支持流式 可能原因：以流式请求方式访问了不支持流式的模型
ReqTextExistRisk	1709813	请求信息存在风险 可能原因：请求信息有风险，被系统屏蔽
RespTextExistRisk	1709814	生成信息存在风险 可能原因：生成信息有风险，被系统屏蔽
EndpointRateLimitExceeded	1709815	访问节点被限流 可能原因：系统访问超限制
ServiceConnectionRefused	1709816	服务访问被拒绝 可能原因：后台系统被拥有者关闭，或者无可用实例提供服务。请联系平台咨询处理。
ServiceConnectionClosed	1709817	服务访问被关闭 可能原因：系统服务发现有问题。请联系平台咨询处理
UnauthorizedUserForEndpoint	1709818	无权访问服务节点 可能原因：服务节点设置访问白名单，访问者不在白名单中
InvalidEndpointWithNoURL	1709819	服务无有效服务信息 可能原因：服务还在启动，或者还没有开启对外服务，可以稍后重试
EndpointAccountRpmRateLimitExceeded	1709820	请求已超过帐户 RPM (Requests Per Minute) 限制 可能原因：RPM 限额为主账户下的所有子帐户共用，默认限制每分钟 60 请求，可以稍后重试。
EndpointAccountTpmRateLimitExceeded	1709821	请求已超过帐户 TPM (Tokens Per Minute) 限制 可能原因：TPM 限额为主账户下的所有子帐户共用，默认限制每分钟 60000 token，可以稍后重试。
ServiceResourceWaitQueueFull	1709822	服务请求队列资源紧张 可能原因：模型服务负载有限，可以稍后重试。
EndpointIsPending	1709823	模型服务节点正在启动 可能原因：服务在启动中，可以稍后重试。
ServiceNotOpen	1709824	模型服务未开通 可能原因：该模型的免费额度已使用完，请到开通管理模块开通相应的模型服务。
TextCheckServiceError	1709827	审核服务失败
APINotSupport	1709828	不支持该接口
ModelNotSupportEmbeddings	1709829	模型不支持embedding
ImageSizeLimitExceeded	1709830	图片大小超过限制 可能原因：不超过10M
ImageFormatNotSupported	1709831	图片格式不对
OnlyOneImageSupported	1709832	不支持多图 可能原因：多模态不支持多张图片
UrlUnSupported	1709834	url格式不符合要求 可能原因：图片相关url，必须是tos、http、https开头
UnauthorizedUserForResource	1709835	相关资源没有权限
ServiceOverdue	1709836	账户余额欠费
ModelLoadingError	1709912	模型加载中 可能原因：lora模型冷启动
ModelAccountRpmRateLimitExceeded	1709837	账户级别模型RPM限流
ModelAccountTpmRateLimitExceeded	1709838	账户级别模型TPM限流