本文介绍了您可能从 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限流 |
