拍我AI 开放平台

获取视频生成状态

概览

接口地址：
GET https://app-api.pixverseai.cn/openapi/v2/video/result/{video_id}

功能： 获取指定 video_id 的生成状态、完成后的视频 URL 及相关元数据。

前置条件

有效的 API 密钥

每次请求使用唯一的 Ai-trace-id

已获得用于查询的 video_id（来自视频生成接口的返回值）

使用步骤

1. 获取 video_id

在提交视频生成请求后，接口会返回一个 video_id，用于后续状态查询。

2. 查询生成状态

使用以下示例命令，以轮询方式获取任务状态：

状态码说明

1：生成成功

5：处理中

7：内容审核未通过

8：生成失败

建议轮询间隔：当状态为 5（处理中）时，建议每 3–5 秒查询一次。

3. 解析接口返回

处理完成后，状态接口将返回状态码 1，表示视频已生成完成。此时，您可以使用响应中的 url 字段来下载或展示生成的视频。

推荐实践

1.

合理设置轮询频率：在状态为 5（处理中）时，建议每 3–5 秒查询一次，以避免过于频繁的请求。

2.

保存关键信息：请妥善保存 video_id，作为后续查询和日志追踪的唯一标识。

修改于 2025-05-27 06:19:29

首尾帧功能使用指南

查询账号余额