错误码

错误分两类：请求错误在提交时立即返回非 2xx 状态码，不产生任务、不扣费；任务失败指任务已创建但生成失败，查询时 status 为 failed，预扣金额自动全额退还。

HTTP 状态码#

状态码	含义	处理方法
400	参数不合规，如模型不支持的分辨率、时长超出范围、素材数量超限、尺寸不支持	按 message 修正参数，重试无效
401	未携带 API Key、密钥错误或已停用	检查 `Authorization` 头，见鉴权
403	账户余额不足、API Key 额度用尽，或该密钥无权调用此模型	充值或调整 API Key 的额度、模型限制
404	任务不存在，或不属于当前账户	检查任务 ID 与使用的 API Key
429	提交过于频繁，或平台整体繁忙	等待 `Retry-After` 秒后重试，见频率限制
500 / 503	服务暂时不可用	稍后重试，最多 3 次；持续出现请联系我们

常见错误码#

code	状态码	说明
`plugin_request_invalid`	400	请求参数不合规，message 说明具体哪个参数有问题
`model_price_error`	400	该模型暂未开放调用
`insufficient_user_quota`	403	账户余额不足以支付本次预扣金额
`task_submit_rate_limited`	429	超过账户的每秒提交上限（默认 5 个），带 Retry-After
`upstream_submit_saturated`	429	平台整体繁忙，请稍后再试
`fail_to_fetch_task`	4xx / 5xx	视频生成服务拒绝或暂时无法受理，message 说明原因

错误响应的两种 JSON 结构见通用约定 · 错误响应。

任务失败原因#

任务失败时，查询结果的 error.code 为失败类别，error.message 依次包含中文说明、类别代码和服务返回的原始原因。

error.code	说明	处理方法
`InputTextSensitiveContentDetected` 等	输入的文本 / 图片 / 视频 / 音频未通过内容安全审核（代码中 InputText、InputImage、InputVideo、InputAudio 分别对应）	修改提示词或更换素材后重新提交
`OutputVideoSensitiveContentDetected`	生成的视频未通过内容安全审核	调整提示词描述后重新提交
`InvalidParameter` 等	参数不符合模型要求	按 message 修正参数
`task_failed`	其他生成失败，如任务超过有效期未完成、服务异常	直接重新提交；持续出现请联系我们

失败任务的预扣金额会自动全额退还，可在调用日志中看到对应的退款记录。