Skip to main content
GET
国产视频模型查询

国产视频模型查询

提交任务后,使用任务 ID 轮询查询。国产视频模型查询接口会返回统一的视频任务状态、进度、错误信息和结果地址。

查询任务

获取视频内容

状态映射

响应中的 progress 表示任务进度;失败时可从 error.codeerror.message 查看错误原因。任务完成后,video_url 会返回生成结果地址。

响应字段

string
任务 ID。通常与提交接口返回的 task_id 一致。
string
对象类型,固定为 video
string
请求时使用的模型名称,可能是基础模型,也可能是组合计费模型。
string
任务状态,常见值为 queuedprocessingcompletedfailedcancelled
integer
任务进度百分比。进度不可用时可能为空或为默认值。
integer
创建时间戳。
integer
完成时间戳。任务未完成时可能为空。
integer
结果过期时间戳。是否返回取决于任务配置和存储方式。
string
输出视频时长。
string
输出尺寸或分辨率描述。
string
生成完成后的视频地址。
object
附加信息。完成后通常会包含结果 URL 等便于前端或转存流程使用的信息。
object
错误信息。任务失败时通常会包含错误码和错误消息。

成功响应示例

失败响应示例

排查建议

  • 如果动作控制任务失败并提示 videoUrl must not be blank,确认 metadata.video_urlmetadata.file_infos 中是否提供了 Category=Video 的视频参考。
  • 如果任务完成但没有 video_url,确认任务结果文件地址是否已生成并可访问。
  • 如果比例或分辨率不符合预期,生成时显式传 metadata.output_config.resolutionmetadata.output_config.aspect_ratio
  • 如果对口型计费时长和请求时长不一致,检查是否命中 scene_type=lip_sync 不足 5 秒按 5 秒计的规则。

相关页面