文本生成视频使用指南

功能概览

文生视频接口支持通过输入文本（prompt）及可选参数，生成符合描述的短视频。

接口地址：POST https://app-api.pixverseai.cn/openapi/v2/video/text/generate

在线调用： https://docs.platform.pai.video/300925802e0

前提条件

在开始前，请确保您已具备：

有效的 API Key

每次请求都携带唯一的 Ai-trace-id

购买的API积分或有效订阅

明确的视频文字描述（prompt）

快速调用

1: 文生视频生成接口

2. 查询视频生成状态并下载视频

使用步骤

1. 编写文字描述（Prompt）

Prompt 的质量直接影响生成效果。建议：

具体且详尽，描述场景、动作、光线、氛围等；

控制在 25–200 字之间，以获得最佳效果。

示例：

✅ 优秀示例：“日出时分，群山环绕的宁静湖面上轻雾缭绕。镜头缓缓从湖心拉近，金色阳光在水面投射斑驳光影，几只水鸟掠过水面，清晨静谧而祥和。”

❌ 不足示例：“山间湖泊日出”

2. 准备您的 API 请求

构造您的 API 请求并填写相应参数：

3. 参数说明

https://docs.platform.pai.video/300925802e0

4. 处理接口返回

调用成功后，接口会返回包含 video_id 的 JSON 响应：

5. 查询生成状态

使用“获取视频生成状态”接口轮询 video_id，监控 status 字段；

当 status 从 5 变为 1 时，即可通过 url 下载视频。

  {
 "ErrCode": 0,
 "ErrMsg": "string",
 "Resp": {
   "create_time": "string",
   "id": 0,
   "modify_time": "string",
   "negative_prompt": "string",
   "outputHeight": 0,
   "outputWidth": 0,
   "prompt": "string",
   "resolution_ratio": 0,
   "seed": 0,
   "size": 0,
   "status": 5,
   "style": "string",
   "url": "string"
 }
}

6. 获取并下载视频

Status 为 1时, url 即为视频文件下载链接。您可以通过返回结果中的 url 获得生成的视频。

功能概览#

前提条件#

快速调用#

使用步骤#

1. 编写文字描述（Prompt）#

2. 准备您的 API 请求#

3. 参数说明#

4. 处理接口返回#

5. 查询生成状态#

6. 获取并下载视频#