PixVerse 查询视频
使用创建接口返回的原生任务 ID 查询状态与视频结果。
GET
/openapi/v2/video/result/{task_id}Authorization
bearerAuth AuthorizationBearer <token>
使用平台 API Key,格式为 Authorization: Bearer your-api-key。
In: header
Path Parameters
task_id*string
创建接口返回的 Resp.video_id。保留完整数字,不添加前缀。
Match
^[0-9]+$Header Parameters
Ai-trace-id?string
可选的唯一追踪值;未传由平台生成。不是幂等键。
Response Body
application/json
application/json
application/json
application/json
读取任务状态
HTTP 200 只表示查询请求得到响应;先检查 ErrCode,再检查 Resp.status。5 为处理中,可每隔 3~5 秒查询一次;1 为成功,从 Resp.url 读取视频地址。7 为审核失败,8 为生成失败,均应停止原样轮询。
请保存完整的原生任务 ID,不要因生成耗时较长而直接重复创建。成功后及时下载或转存视频。
PixVerse 查询视频官方文档查看对应的上游协议定义。