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