拍我AI 开放平台
  1. API指南
拍我AI 开放平台
  • 开始使用
  • v5.5 重磅更新!
  • API指南
    • API 工作流程
    • 如何购买API 服务
    • 检查账户余额
    • 文本生成视频使用指南
    • 图像生成视频使用指南
    • 特效模板使用指南
    • 首尾帧功能使用指南
    • 续写(Extend)功能使用指南
    • 对口型(Lipsync)接口使用指南
    • 音效生成(背景音乐)使用指南
    • 多主体功能使用指南
    • 重绘功能使用指南
    • 多帧(Multi-transiton)功能 使用指南
    • 视频编辑(Swap)使用指南
    • 获取视频生成状态
    • 如何使用Webhook 回调?
  • API 接口
    • 查询账号余额
      GET
    • 上传图片
      POST
    • 生成文生视频
      POST
    • 生成图生视频
      POST
    • 首尾帧生成视频
      POST
    • 获取视频状态
      GET
    • 上传资源(视频/音频)
      POST
    • 生成对口型(Lipsync)视频
      POST
    • 获取TTS 音色
      GET
    • 生成延长(Extend)视频
      POST
    • 音效生成(sound_effect)接口
      POST
    • 多主体生成视频
      POST
    • 重绘视频生成视频
      POST
    • 重绘效果列表
      GET
    • 视频编辑(Swap) Mask 生成
      POST
    • 视频编辑(Swap) 视频生成
      POST
    • 多帧(Multi-transition) 视频生成
      POST
  • 产品计费
    • 模型与点数消耗
    • 预付资源包与企业定制
  • 问题排查
    • 常见错误及解决方案
    • FAQ
  • 资源中心
    • 技术支持/联系我们
    • 更新日志
    • 服务条款
    • 隐私协议
    • 附加工具
  1. API指南

获取视频生成状态

概览#

接口地址：
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
上一页
视频编辑(Swap)使用指南
下一页
如何使用Webhook 回调?
Built with