错误码

错误码（Code）

错误信息（Message）

原因

处理方法

输入参数错误

InvalidParameter

Invalid request parameter: %s

请求参数缺失、格式不符、类型错误或取值超出范围。具体字段名见 Message。

对照对应 API 文档检查参数名、类型、必填项与取值范围。

InputContentBlocked

Input content violates policy, please modify and retry: %s

输入文本 / 图片触发内容安全审核（敏感词、违规图像等）。

修改输入内容后重试。如属误报，请联系技术支持。

鉴权与账号

CallerTypeNotSupported

Caller type not supported: %s (only main account 'customer' and sub-account 'sub' are allowed)

使用了不支持的账号类型调用接口。

改用阿里云主账号或 RAM 子账号鉴权调用。详见鉴权方式。

UserStatusInvalid

用户状态异常: %s

阿里云账号状态异常（如未实名认证、被冻结）。

登录阿里云控制台检查账号状态。

服务与配额

ServiceNotOpened

Service not activated, please activate the service first: %s

调用了未开通的 Aidge 子服务（如调图片翻译但未开通该 SKU）。

前往 Aidge 控制台开通对应服务。

ServiceStatusInvalid

Service status abnormal, please contact the administrator: %s

账号或服务存在停机、欠费等异常状态。

检查阿里云账号余额并补缴欠费，或联系技术支持。

FreeQuotaExhausted

Free quota exhausted; disable the 'stop-when-exhausted' switch or purchase a package: %s

试用额度耗尽且未购买付费额度。

前往 Aidge 控制台购买商品包，或在额度管理页面关闭"用完即停"。

PriorityUnavailable

Request priority unavailable: %s

使用了不支持的优先级参数。

检查请求参数中的优先级设置是否在允许范围内。

输出与下游

OutputContentBlocked

Output content violates policy: %s

模型生成内容触发内容安全审核，未能返回。

调整输入语义后重试，或联系技术支持。

DownstreamUnavailable

Service temporarily unavailable, details: %s

下游模型服务、图片下载服务等暂时不可用。

稍后重试。如持续出现，请联系技术支持。

系统内部错误

UsageParseFail

Internal system error: %s

用量统计解析失败（不影响请求结果）。

重试请求。如持续出现，请保留 RequestId 联系技术支持。

BillingPushFail

Internal system error: %s

计费数据推送失败。

重试请求。如持续出现，请保留 RequestId 联系技术支持。

InternalError

System is busy, please retry later: %s

系统兜底错误，未匹配到具体错误类型。

稍后重试。如持续出现，请保留 RequestId 联系技术支持。

错误码（Code）

HTTP 状态

错误信息（Message）

处理方法

ServiceUnavailable

503

The request has failed due to a temporary failure of the server.

线性退避 1-3 次重试。如持续出现，请保留 RequestId 联系技术支持。

Throttling

429

Request was denied due to flow control.

指数退避（建议起始 1s，1s / 2s / 4s / 8s）并降低并发。如需提升配额，联系技术支持。

Throttling.Api

429

Request was denied due to api flow control.

API 维度限流。关注单 API 的 QPS 配额，详见频率限制。

Throttling.User

429

Request was denied due to user flow control.

用户维度限流。降低并发后重试；如需提升，提工单申请提额。

NoPermission

403

You are not authorized to perform this action.

检查 RAM 子账号是否绑定了对应 API 的访问策略（如 AliyunAidgeFullAccess）。详见鉴权方式。

UnknownError

500

The request processing has failed due to some unknown error.

携带 RequestId 联系技术支持。

IncompleteSignature

400

The request signature does not conform to Alibaba Cloud standards.

检查 HMAC-SHA256 签名计算过程。详见鉴权方式。

InternalError

500

The request processing has failed due to some unknown error.

携带 RequestId 联系技术支持。与业务层同名错误码 Message 不同。

InvalidParameter

400

The specified parameter "%s" is not valid.

检查参数值是否在平台允许范围内。与业务层同名错误码 Message 不同。

MissingParameter

400

%s is mandatory for this action.

补充缺失的必填参数后重试。

状态码

含义

处理方法

200

请求成功送达。具体业务结果以响应体 Code 字段为准（"Success" 表示成功）。

--

400

请求格式错误。常见对应业务码：InvalidParameter / MissingParameter / IncompleteSignature。

按响应体 Code 处理。

401

鉴权失败。AK/SK 签名错误或 token 过期。

检查 AccessKey 与签名计算过程。详见鉴权方式。

403

无权限。对应业务码 NoPermission。

检查 RAM 子账号权限。

429

请求频率超过 QPS 限制。对应业务码 Throttling / Throttling.Api / Throttling.User。

指数退避后重试。详见频率限制。

500

服务端内部错误。常见对应业务码：InternalError / UnknownError / DownstreamUnavailable。

按响应体 Code 处理。

503

服务暂时不可用。对应业务码 ServiceUnavailable。

线性退避重试。