先检查账户余额是否高于200元，并确认资源包余量与有效期正常；再核对输入文件数量、格式以及提示词是否符合要求；最后排查 API 请求头、model 字段是否填写正确，并结合 error_code 错误码快速定位问题原因。

在火山引擎 Seedance 平台提交视频生成任务后，如果长时间停留在“处理中”状态，或直接提示失败，通常需要从账户状态、请求参数、资源包配置以及模型调用这几个层面逐项排查，才能更快找到故障点。

检查账户与资源包状态

登录火山引擎控制台 → 进入「费用中心」→ 查看「账户余额」是否 【大于200元】；如果余额不足，Seedance 2.5/2.0 系列模型通常无法正常调度任务。即便已经购买节省计划，也要进一步确认该计划是否已成功绑定到当前项目。

前往「AI服务」→「Seedance」→「资源包管理」，检查所选模型（例如 Seedance 2.5 1080P）对应的资源包余量是否 > 0，同时确认资源包仍在有效期内——【过期资源包不会自动续费，也不会触发余额兜底】。

这一步排查非常直接，只需将鼠标悬停在资源包名称上，即可查看剩余秒数和具体到期时间。

验证输入内容合规性

方法一：全模态参考生视频（图片+视频+音频混合）

先确认上传文件总数是否超出平台限制：Seedance 2.5 最多支持30张图片 + 10个视频 + 10段音频；Seedance 2.0 仅支持9张图片 + 3个视频 + 3段音频，并且【不支持单独上传音频，必须至少包含1张图片或1个视频】。

方法二：首尾帧图生视频

确认首帧和尾帧都为静态图片（PNG/JPEG 格式），建议分辨率不低于512×512；如果任意一帧使用的是 GIF 或 WebP 动图，任务可能会静默失败，而且不会返回明显报错信息。

方法三：纯文生视频

提示词长度建议控制在1～120字符之间，尽量避免使用非常规特殊符号（如★、※、①等）；同时减少“高清”“4K”“电影质感”这类重复或冗余描述，因为模型本身已内置画质优化策略，过多修饰词反而可能影响语义理解与生成效果。

排查API调用异常

第一步：确认请求头中的 Authorization 字段值有效，并检查对应的 AccessKey 是否被禁用、过期，或因轮转导致失效。

接下来这一步尤其关键：务必仔细核对请求体中的model字段，它必须与已开通的模型名称完全一致。例如 Seedance 2.5 1080P 的 model_name 必须填写为seedance-2p5-1080p；如果误写成seedance-2.5-1080p或seedance25_1080，系统通常会直接返回400错误。

第三步：查看响应 body 中的error_code字段：
• code=1001，通常表示资源包已耗尽或账户余额不足；
• code=2003，表示输入文件解析失败（常见于音频采样率不是16kHz，或视频帧率不是24/25/30fps）；
• code=4005，说明提示词中包含违禁词或敏感实体，需要修改后再重新提交。

第四步：如果使用异步模式，调用 get_task_status 接口时传入的 task_id 必须与 create_task 返回的 id 完全一致，区分大小写，且不能包含空格或换行符。