查询任务状态

视频生成类接口通常先返回 video_id，随后通过查询接口获取任务状态和生成结果。

接口地址

Path 参数

参数	类型	是否必填	说明
`video_id`	integer	是	视频任务 ID

状态码说明

status	说明
`1`	生成完成，可使用返回的 `url`
`5`	生成中
`7`	审核内容失败
`8`	生成失败

字段填写备注

字段	填写建议
`API-KEY`	使用正式 API Key，不要放在 URL Query 中。
`Ai-trace-id`	每次请求使用新的 UUID；同一个值重复请求可能被识别为重复任务。
`video_id`	路径参数，填写创建接口返回的 `Resp.video_id`。

响应字段

字段	类型	说明
`id`	integer	视频任务 ID
`prompt`	string	创建任务时使用的提示词；部分能力可能返回空字符串
`negative_prompt`	string	负向提示词；未填写时可能返回空字符串
`resolution_ratio`	integer	服务端返回的画幅比例枚举值
`status`	integer	视频生成状态
`url`	string	视频生成完成后的地址；生成中或失败时可能为空
`size`	integer	服务端返回的视频大小数值；当前公开契约未明确单位
`outputWidth`	integer	输出视频宽度
`outputHeight`	integer	输出视频高度
`quality`	string	任务使用的清晰度档位
`aspect_ratio`	string	画幅比例；部分任务可能返回空字符串
`seed`	integer	生成使用的随机种子
`style`	string	风格；未设置时可能返回空字符串
`has_audio`	boolean	返回视频是否包含音频
`credits`	integer	本次任务对应的 Credits
`create_time`	string	创建时间
`modify_time`	string	更新时间
`customer_paths`	object \| null	能力专属扩展信息；字段结构随能力变化，普通任务可能为 `null`

响应示例

{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "id": 123456789,
    "prompt": "continue naturally",
    "negative_prompt": "",
    "resolution_ratio": 0,
    "url": "https://media.pixverseai.cn/path/to/video.mp4",
    "size": 34,
    "seed": 1424686686,
    "status": 1,
    "style": "",
    "create_time": "2026-07-26T12:17:09Z",
    "modify_time": "2026-07-26T12:18:04Z",
    "outputWidth": 960,
    "outputHeight": 540,
    "quality": "360p",
    "aspect_ratio": "",
    "has_audio": true,
    "credits": 75,
    "customer_paths": null
  }
}

上述示例字段来自国内接口实际完成态响应，ID、URL、时间和内容已替换为公开文档占位值。customer_paths 可能包含不同能力的专属信息，不应在通用 Schema 中固定其子字段。

调用建议

当 status = 1 时，视频生成完成。

当 status = 5 时，任务仍在生成中。

当 status = 7 时，表示审核失败，请检查输入内容。

当 status = 8 时，表示生成失败。

如 status ≠ 1 时，访问视频url链接, 会看不见视频. status 为 1之后, 重复打开，会出现视频无法播放，因为链接命中浏览器缓存，需要清楚浏览器缓存 + 无痕模式后重新打开链接进行视频访问.

查询任务状态

查询任务状态

接口地址

Path 参数

状态码说明

字段填写备注

响应字段

响应示例

调用建议

请求参数

返回响应

查询任务状态

查询任务状态#

接口地址#

Path 参数#

状态码说明#

字段填写备注#

响应字段#

响应示例#

调用建议#

请求参数

返回响应

查询任务状态

接口地址

Path 参数

状态码说明

字段填写备注

响应字段

响应示例

调用建议