功能简介

用于查询 Omni 视频任务的处理结果。传入创建任务时获得的 task_id，即可查看任务进度、失败原因、最终视频地址和带水印视频地址。

使用场景

• 想知道 Omni 视频是否已经生成完成
• 想拿最终的视频下载地址
• 想看失败原因

参数说明

输入参数

参数名	类型	必填	用户视角说明
access_key	String	是	接口账号。
secret_key	String	是	接口密码。
task_id	String	是	可灵返回的任务编号，也就是创建接口返回的 task_id。

输出参数

参数名	类型	用户视角说明
task_id	String	当前任务编号。
task_status	String	任务状态。可返回 submitted、processing、succeed、failed；分别表示已提交、生成中、生成成功、生成失败。
task_status_msg	String	状态说明。失败时优先看这个。
video_urls	String[]	视频下载地址。最重要的字段。
watermarked_video_urls	String[]	带水印视频下载地址。如果创建任务时开了带水印版本，生成成功后看这里。
raw_json	String	官方完整结果。创建时间、更新时间、扣费、视频时长等不常看的信息都在这里。

注意事项

• task_id 必须填写，直接填创建接口返回的任务编号。
• 任务还在生成中时，video_urls 和 watermarked_video_urls 为空是正常的。
• video_urls 是最终视频下载地址；官方说明生成的图片或视频会在 30 天后被清理，拿到后建议尽快保存。
• 如果创建时没有开启带水印版本，watermarked_video_urls 为空也是正常的。
• 如果需要视频时长、扣费、创建时间等细节，到 raw_json 里查看。