腾讯混元文生视频任务返回FAILED状态时，须依三步法精准排查：先调DescribeVideoEditKlingJob确认Status为全大写FAIL；再依据ErrorCode（如InvalidParameter、ResourceInsufficient、FailedOperation）分类定位参数、资源或系统错误；最后按类型采取对应措施。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元文生视频任务返回 FAILED 状态时，必须立即定位错误根源，否则重提任务仍会失败；不能仅靠重试或修改提示词蒙混过关。
第一步：确认任务是否真失败
调用 DescribeVideoEditKlingJob 接口查询任务详情，检查 Status 字段是否为 FAIL —— 注意大小写，fail 或 failed 都不是合法值，只有全大写 FAIL 才代表失败。
若 Status 是 RUN 或 DONE，说明任务仍在运行或已成功，此时看到的“failed”可能是前端缓存、日志误读或 SDK 解析异常，无需查错。
第二步：提取核心错误线索
在接口返回中，直接定位两个关键字段：ErrorCode 和 ErrorMessage。
ErrorCode 是结构化错误码，例如 FailedOperation.DriverFailed、InvalidParameter.PromptTooLong、ResourceInsufficient.QuotaExceeded —— 它比 ErrorMessage 更精准，是排查路径的起点。
ErrorMessage 是人类可读描述，如“驱动失败”“提示词超长”“配额不足”，但部分错误信息过于笼统（如“内部服务异常”），此时必须以 ErrorCode 为准，不能依赖 ErrorMessage 做判断。
第三步：按 ErrorCode 类型分路径排查
方法一：参数类错误（ErrorCode 含 InvalidParameter）
常见于 Prompt 过长（超过512字符）、负向提示词含非法符号、分辨率参数非 1080p/720p/480p 整数倍、时长指定为小数或负值。重点检查 Prompt 和 VideoConfig 字段原始输入，不要信任前端自动截断或格式化后的值。
方法二：资源类错误（ErrorCode 含 ResourceInsufficient 或 QuotaExceeded）
当前账号在该地域（Region）的混元视频生成配额已耗尽，或账户余额不足 0.5 元。需登录腾讯云控制台 → 访问管理 → 配额中心 → 搜索“Kling-Omni-Video”，查看“每日调用次数”和“积分数余额”。【积分数不足时，即使配额充足，任务也会静默失败】。
方法三：系统类错误（ErrorCode 含 InternalError 或 FailedOperation）
例如 FailedOperation.DriverFailed 表示后端渲染节点异常，通常持续时间小于 3 分钟；此时应等待 5 分钟后重查任务状态，不要立即重提——重复提交会加剧队列压力，且新任务仍可能分配到故障节点。
