本文介绍了您可能从 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. | 没有访问该资源的权限，请检查权限设置，或联系管理员添加白名单。 |
| 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限流 |