本文介绍了您可能从 API 和官方 SDK 中看到的错误代码。
http code | 说明 |
---|---|
400 | 原因:错误的请求,例如缺少必要参数,或者参数不符合规范等 |
401 | 原因:认证错误,代表服务无法对请求进行认证。签名缺失/API key解析失败/ak找不到等错误为认证错误 |
402 | 原因:表示客户端必须付费才能访问所请求的资源 |
403 | 原因:权限错误,ak/sk、API key 没有对应 Endpoint 权限 |
404 | 原因:调用的接口不存在、不支持 |
429 | 原因:最大 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 | 鉴权签名信息不匹配 |
RequestTimeout | 1709802 | 请求超时 |
ServiceConnectionTimeout | 1709803 | 服务连接超时 |
MissingAuthenticationHeader | 1709804 | 缺少鉴权的header |
AuthenticationHeaderIsInvalid | 1709805 | 鉴权信息无效 |
InternalServiceError | 1709806 | 系统服务异常 |
MissingParameter | 1709807 | 缺少参数 |
InvalidParameter | 1709808 | 无效参数 |
AuthenticationExpire | 1709809 | 鉴权信息超时 |
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) 限制 |
EndpointAccountTpmRateLimitExceeded | 1709821 | 请求已超过帐户 TPM (Tokens Per Minute) 限制 |
ServiceResourceWaitQueueFull | 1709822 | 服务请求队列资源紧张 |
EndpointIsPending | 1709823 | 模型服务节点正在启动 |
ServiceNotOpen | 1709824 | 模型服务未开通 |
TextCheckServiceError | 1709827 | 审核服务失败 |
APINotSupport | 1709828 | 不支持该接口 |
ModelNotSupportEmbeddings | 1709829 | 模型不支持embedding |
ImageSizeLimitExceeded | 1709830 | 图片大小超过限制 |
ImageFormatNotSupported | 1709831 | 图片格式不对 |
OnlyOneImageSupported | 1709832 | 不支持多图 |
UrlUnSupported | 1709834 | url格式不符合要求 |
UnauthorizedUserForResource | 1709835 | 相关资源没有权限 |
ServiceOverdue | 1709836 | 账户余额欠费 |
ModelLoadingError | 1709912 | 模型加载中 |
ModelAccountRpmRateLimitExceeded | 1709837 | 账户级别模型RPM限流 |
ModelAccountTpmRateLimitExceeded | 1709838 | 账户级别模型TPM限流 |