You need to enable JavaScript to run this app.
导航
错误码
最近更新时间:2025.11.07 14:37:00首次发布时间:2024.07.10 15:15:35
复制全文
我的收藏
有用
有用
无用
无用

本文列举您调用火山方舟 API 可能会涉及的错误码信息,包含方舟错误码和公共错误码。

方舟错误码

HTTP
状态码

错误类型
Type

错误码
Code

错误信息
Message

含义

400

BadRequest

MissingParameter

The request failed because it is missing one or multiple required parameters. Request ID: {id}

请求缺少必要参数,请查阅 API 文档。

400

BadRequest

InvalidParameter

One or more parameters specified in the request are not valid. Request ID: {id}

请求包含非法参数,请查阅 API 文档。

400

BadRequest

InvalidParameter

The parameter instructions specified in the request are not valid: caching is not supported for instructions. Request id: {id}

Responses API 中,当配置过 instructions 字段信息,后续轮次无法配置 Caching 字段。

400

BadRequest

InvalidEndpoint.ClosedEndpoint

The request targeted an endpoint that is currently closed or temporarily unavailable. Request ID: {id}

推理接入点处于已被关闭或暂时不可用, 请稍后重试,或联系推理接入点管理员。

400

BadRequest

SensitiveContentDetected

The request failed because the input text may contain sensitive information.

输入文本可能包含敏感信息,请您使用其他 prompt。

400

BadRequest

SensitiveContentDetected.SevereViolation

The request failed because the input text may contain severe violation information.

输入文本可能包含严重违规相关信息,请您使用其他 prompt

400

BadRequest

SensitiveContentDetected.Violence

The request failed because the input text may contain violence information.

输入文本可能包含激进行为相关信息,请您使用其他 prompt

400

BadRequest

InputTextSensitiveContentDetected

The request failed because the input text may contain sensitive information.Request ID: {id}

输入文本可能包含敏感信息,请您更换后重试。

400

BadRequest

InputImageSensitiveContentDetected

The request failed because the input image may contain sensitive information.Request ID: {id}

输入图像可能包含敏感信息,请您更换后重试。

400

BadRequest

InputVideoSensitiveContentDetected

The request failed because the input video may contain sensitive information.

输入视频可能包含敏感信息,请您更换后重试。

400

BadRequest

OutputTextSensitiveContentDetected

The request failed because the output may contain sensitive information.

生成的文字可能包含敏感信息,请您更换输入内容后重试

400

BadRequest

OutputImageSensitiveContentDetected

The request failed because the output image may contain sensitive information.

生成的图像可能包含敏感信息,请您更换输入内容后重试。

400

BadRequest

OutputVideoSensitiveContentDetected

The request failed because the output video may contain sensitive information.Request ID: {id}

生成的视频可能包含敏感信息,请您更换输入内容后重试。

400

BadRequest

InvalidParameter.{{Parameter}}

The specified parameter {{Parameter}} is invalid.

请求参数值不合法。请检查参数值的正确性后重试。

400

BadRequest

MissingParameter.{{Parameter}}

The required parameter {{Parameter}} is missing.

缺少必要的请求参数。请确认请求参数后重试。

400

BadRequest

Duplicate.Tags.Key

The specified object of tags contains duplicate keys.

对象的标签存在重复Key。

400

BadRequest

InvalidArgumentError

MissingRole:Invalid message: {{Message}}

请求中的 messages 列表里,有消息体缺少 role 字段

400

BadRequest

InvalidArgumentError.UnknownRole

Unknow the role of message: {{Role}}

消息体中的 role 值不被支持,如user_

400

BadRequest

InvalidArgumentError.UnknownRole

The Inference role not found: {{Role}}

指定的 inference_role 未在配置中定义。

400

BadRequest

InvalidArgumentError.InvalidImageDetail

Invalid image detail: {{Parameter}}

image_url 中的 detail 参数值无效,只接受 "auto", "high", "low"

400

BadRequest

InvalidArgumentError.InvalidPixelLimit

Customized min_pixels 100 is greater than max_pixels 50

用户自定义的图片像素限制(min_pixels, max_pixels)无效(例如 min_pixels > max_pixels,或超出了服务配置的范围)

400

BadRequest

InvalidImageURL.EmptyURL

Empty base64 image url

传入的图片 URL 为空

400

BadRequest

InvalidImageURL.InvalidFormat

Invalid base64 image url

无法解析或处理图片,可能是 Base64 格式不正确、图片数据损坏或格式不支持

400

BadRequest

OutofContextError

Total tokens of image and text exceed max message tokens.

当请求中包含图片时,文本和图片编码后的总 token 数超过了模型上下文长度限制

400

Forbidden

InvalidSubscription

Your account ({{account_identifier}}) does not have a valid coding plan subscription, or your subscription has expired. Please visit {{subscription_check_url}} to review your subscription status or complete the subscription or renewal process.

Coding Plan 套餐未订阅或已过期。

401

Unauthorized

AuthenticationError

The API key or AK/SK in the request is missing or invalid. Request ID: {id}

请求携带的 API Key 或 AK/SK 校验未通过,请您重新检查设置的 鉴权凭证,或者查看 API 调用文档来排查问题。

401

Forbidden

InvaildAccountStatus

There is an issue with your account status. If you need assistance, please contact the platform administrators.

当前使用的账号异常。

403

Forbidden

OperationDenied.InvalidState

The specified context is in invalid state: InProgress.Request ID: {id}

请求所关联的Context ID处于非空闲状态,不可调用。

403

Forbidden

OperationDenied.ConflictedValidationSet

Operation is denied because it is not supported to configure ValidationSet and ValidationPercentage at the same time.

无法同时上传验证集和设置训练集取样为验证集百分比,不支持该操作。

403

Forbidden

OperationDenied.PermissionDenied

Operation is denied because you are not permitted to access the specified configuration of the FoundationModel.

您没有权限访问基础模型的配置,不支持该操作。

403

Forbidden

OperationDenied.UnsupportedCustomizationType

Operation is denied because the specified CustomizationType is not supported by the CustomModel.

模型不支持该训练方法,不支持该操作。

403

Forbidden

OperationDenied.CustomizationNotSupported

Operation is denied because the specified version of the FoundationModel is not configured for the specified type of customization.

基础模型的版本不支持该训练方法,不支持该操作。

403

Forbidden

OperationDenied.ServiceNotOpen

Operation is denied because the model service is unavailable, please go to the Volcano Ark console activation management page to activate the corresponding model service, or submit a work order to contact us.

模型服务不可用,不支持该操作。请前往火山方舟控制台激活模型服务,或提交工单联系我们。

403

Forbidden

OperationDenied.ServiceOverdue

Operation is denied because your account balance is overdue, please go to the Volc Trading Center to recharge in order to continue using the service.

您的账单已逾期,不支持该操作。请前往火山费用中心充值。

403

Forbidden

AccountOverdueError

The request failed because your account has an overdue balance. Request ID: {id}

当前账号欠费(余额<0),如需继续调用,请前往 火山引擎费用中心 进行充值,详细操作参见 充值操作指引

403

Forbidden

AccessDenied

The request failed because you do not have access to the requested resource. Request ID: {id}

没有访问该资源的权限,请检查权限设置,或联系管理员添加白名单。

403

Forbidden

OperationDenied.InvalidState

Operation is denied because the specified context is in invalid state: InProgress. Request id: {id}

请求的缓存信息状态是不可用状态。请查看缓存信息是否正在被更新中。

403

Forbidden

OperationDenied.UnsupportedPhase

Operation is denied because operation is not supported while the target is in its current phase.

操作失败,操作目标在特殊状态,请检查目标是否存在或者被锁定等特殊状态中。

404

NotFound

InvalidEndpointOrModel.NotFound

The model or endpoint %s does not exist or you do not have access to it.

模型或者推理接入点 %s 不存在或者您无权访问它。

404

NotFound

ModelNotOpen

Your account %s has not activated the model %s. Please activate the model service in the Ark Console.

当前账号 %s 暂未开通 %s 模型服务,请前往火山方舟控制台开通管理页开通对应模型服务。

404

NotFound

NotFound.{{Parameter}}

The specified {{ResourceType}} {{ResourceContent}} is not found.

指定资源找不到。请确认参数后重试。

404

NotFound

InvalidEndpointOrModel.ModelIDAccessDisabled

Accessing the model via Model ID is not allowed for your account. Please use a custom endpoint ID instead. Request id:{id}

未能找到指定的模型ID。你的账号不允许使用模型ID来调用模型,请确认你账号权限或者使用有权限的推理接入点 ID 来调用模型服务。

404

NotFound

UnsupportedModel

The {{model_name}} model does not support the coding plan feature. Please refer to the documentation at {{doc_url}} to select a compatible model.

当前模型不支持 Coding Plan。

429

TooManyRequests

RateLimitExceeded.EndpointRPMExceeded

The Requests Per Minute (RPM) limit of the associated endpoint for your account has been exceeded. Request ID: {id}

请求所关联的推理接入点已超过 RPM (Requests Per Minute) 限制, 请稍后重试。

429

TooManyRequests

RateLimitExceeded.EndpointTPMExceeded

The Tokens Per Minute (TPM) limit of the associated endpoint for your account has been exceeded. Request ID: {id}

请求所关联的推理接入点已超过 TPM (Tokens Per Minute) 限制, 请稍后重试。

429

TooManyRequests

ModelAccountRpmRateLimitExceeded

RPM (Requests Per Minute) limit of the model is exceeded. Request ID: {id}

请求已超过帐户模型 RPM (Requests Per Minute) 限制: 请您稍后重试, 或者联系平台技术同学进行解决

429

TooManyRequests

ModelAccountTpmRateLimitExceeded

TPM (Tokens Per Minute) limit of the model is exceeded. Request ID: {id}

请求已超过帐户模型 TPM (Tokens Per Minute) 限制: 请您稍后重试, 或者联系平台技术同学进行解决

429

TooManyRequests

APIAccountRpmRateLimitExceeded

The RPM (Requests Per Minute) limit for the API on your account has been exceeded. Request ID: {id}

当前账号该接口的RPM (Requests Per Minute)限制已超出,请稍后重试。

429

TooManyRequests

ModelAccountIpmRateLimitExceeded

IPM (Images Per Minute) limit of the model is exceeded.

请求已超过账户模型 IPM (Images Per Minute) 限制: 请您稍后重试, 或者联系平台技术同学进行解决

429

TooManyRequests

QuotaExceeded

Your account [%s] has exhausted its free trial quota for the [%s] model. Request ID: {id}

当前账号 %s 对 %s 模型的免费试用额度已消耗完毕,如需继续调用,请前往火山方舟控制台开通管理页开通对应模型服务。

429

TooManyRequests

QuotaExceeded

The request has exceeded the quota. Request ID: {id}

当前账号处于排队中状态的任务数已超过限制,请稍后重试。

429

TooManyRequests

ServerOverloaded

The service is currently unable to handle additional requests due to server overload. Please retry later. Request ID: {id}

服务资源紧张,请您稍后重试。常出现在调用流量突增或刚开始调用长时间未使用的推理接入点。

429

TooManyRequests

SetLimitExceeded

Your account [%s] has reached the set inference limit for the [%s] model, and the model service has been paused. To continue using this model, please visit the Model Activation page to adjust or close the "Safe Experience Mode".
Request ID: {id}

当前账号 %s 对 %s 模型已达到设置的推理限额值,如需继续调用,请前往火山方舟控制台开通管理页修改限额值或关闭安心体验模式。

429

TooManyRequests

InflightBatchsizeExceeded

The Inflight Batchsize limit has been exceeded.Request ID: {id}

您已经达到当前充值金额下的最大并发数限制,您可以充值解锁更大并发额度或降低并发数。

429

TooManyRequests

AccountRateLimitExceeded

Requests are too frequent. Please reduce your request frequency, wait a short moment, and retry your request.

请求超出RPM / TPM限制。

429

TooManyRequests

QuotaExceeded

You have exceeded the 5-hour/weekly/monthly usage quota. It will reset at {{reset_time}}.

使用的额度超出5小时/周/月限额。

500

InternalServerError

InternalServiceError

The service encountered an unexpected internal error. Please retry later. Request ID: {id}

内部系统异常,请您稍后重试。

公共错误码

您可访问公共错误码,获取更多错误码信息。