AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
视频生成PixVerse

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 查询视频官方文档查看对应的上游协议定义。