错误码

常见错误码如下（下表为响应体中的业务 ErrCode，不等同于 HTTP 状态码。）：

Code	Description	说明
`0`	success	成功
`400011`	Empty parameter	参数为空
`400012`	Invalid account	无效账号
`400013`	Invalid binding request: incorrect parameter type or value	无效绑定请求：参数类型或值错误
`400017`	Invalid parameter	参数无效
`400018`	Prompt length exceeds limit	提示词或负向提示词超过长度限制
`400019`	Prompt / negative prompt length exceeds limit	提示词或负向提示词超过长度限制
`400032`	Invalid image ID	图片 ID 无效
`500008`	Requested data not found	请求数据未找到
`500020`	No permission	当前账号无操作权限
`500030`	Image size exceeded	图片大小或分辨率超过限制
`500031`	Failed to retrieve image information	获取图片信息失败
`500032`	Invalid image format	图片格式无效
`500033`	Invalid image width or height	图片宽度或高度无效
`500041`	Image upload failed	图片上传失败
`500042`	Invalid image path	图片路径无效
`500044`	Concurrent generation limit reached	并发生成任务数已达上限
`500054`	Content moderation failure	内容审核未通过
`500060`	Monthly effects activation limit reached	本月特效激活次数已达上限
`500063`	Pre-moderation failed	输入内容未通过审核，请重新输入或替换素材
`500064`	Content has been deleted	内容已被删除，重新上传或者选择其他内容
`500069`	High load	系统负载过高，请稍后重试
`500070`	Template not activated	当前模板未激活
`500071`	Unsupported resolution for effect	当前特效不支持指定分辨率
`500090`	Insufficient balance	余额不足
`500100`	MySQL error	MySQL 错误
`10005`	apiKey is not registered	apikey缺失、无效、过期或撤销
`99999`	Unknown error	未知错误

认证错误

错误示例：Invalid API-KEY

可能原因：

请求头中的 API-KEY 错误或已失效。

API Key 未激活、已撤销或已过期。

将 API Key 放入请求体，而不是请求头。

处理建议：

确认正在使用正确且已激活的 API Key。

确保请求头中包含 API-KEY。

如问题仍然存在，请联系技术支持并提供 Ai-trace-id。

参数错误

错误示例：Invalid parameter、Invalid binding request

处理建议：

检查参数类型是否正确。

检查模型、分辨率、时长、画幅比例等枚举值是否在支持范围内。

检查必填参数是否缺失。

检查提示词长度是否超过限制：文生视频 prompt 以接口说明为准；图生视频 prompt 最长 2048 characters。

内容审核错误

错误示例：Content moderation failure

可能原因：

输入图片、视频或文本触发内容审核。

提示词包含敏感信息或不合规内容。

处理建议：

替换输入图片或视频。

调整提示词表达。

避免上传违规内容。

余额错误

错误示例：Insufficient balance

处理建议：

检查账号剩余点数。

降低生成规格，例如分辨率、时长或音频开关。

如需继续生成，请充值或升级套餐。

认证错误#

参数错误#

内容审核错误#

余额错误#

认证错误

参数错误

内容审核错误

余额错误