视频生成接口通常返回一个任务编号,成片需要等待后续处理。接入时,容易把“任务创建成功”“任务处理完成”和“视频符合要求”记成同一个结果,实际排查时就很难判断问题发生在哪一步。
本文以豆包调用飞影 MCP 的一条数字人口播记录为例,整理这三层结果的检查方式。案例来自飞影开发过程中的已有记录,下面只讨论任务跟踪和成片验收。
1. 用原任务编号跟踪处理结果
创建接口返回任务编号后,应用应保存该编号,并与当次文案和素材选择关联。后续查询围绕原任务进行。
本例通过 get_task_status 查询视频任务。任务还在处理中时,继续等待;查询暂时失败时,保留编号和错误信息,再按接口约定处理。
创建请求超时需要单独看待:客户端没有收到响应,不能据此判断服务端没有受理。应先核对提交记录;没有明确的幂等约定时,不自动重复创建。
客户端结束等待,也不代表服务端任务已经取消。保留编号,才能在之后恢复查询。
2. 下载之后,先检查文件
任务返回完成状态后,进入下载和文件检查。本例使用的短文案是:
第一步写文案,第二步选形象,第三步生成视频。
当时保留的文件记录为:
| 检查项 | 记录 |
|---|---|
| 分辨率 | 1080×1920 |
| 时长 | 4.16 秒 |
| 媒体轨道 | 包含视频轨和音轨 |
| 字幕画面 | 约 2 秒处可见“第二步选形象” |
这些记录分别说明文件的画幅、时长、轨道和一个时刻的字幕情况。存在音轨不能证明朗读完整,一帧出现字幕也不能证明全片字幕正确。
3. 完整播放后,再记录内容结论
文件能够打开后,还需要从头播放到结束,逐项检查:
- 人物和声音是否与确认的方案一致。
- 三个步骤是否按文案读完,开头和结尾是否截断。
- 字幕是否与朗读对应,是否漏句或出现错字。
- 字幕是否遮挡重要画面,人声是否清楚。
应用侧可以把任务状态、文件检查和内容检查分别保存。任务完成后,内容检查仍可以是“待检查”;发现字幕问题时,记录对应文案与时间点,便于复核。
这条记录支持的结论是:任务完成状态可以作为开始下载和验收的条件,交付结论还需要文件检查与完整播放共同确认。