文本生成视频使用指南

概览

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

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

API 参考文档： https://docs.platform.pai.video/300925802e0

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

有效的 API Key

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

已开通并激活订阅计划，且账户中有足够可用额度

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

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

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

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

示例：

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

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

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

参数名	必选	类型	说明
model	是	string	模型版本，例如 "v4.5"
prompt	是	string	视频文字描述，最长 2048 字符
negative_prompt	否	string	负面描述，最长 2048 字符，用于抑制不需要的内容
template_id	否	integer	效果模版 ID，需在效果管理中先行激活。部分效果不支持特定分辨率，请留意效果管理页面说明
style	否	string	风格，可选值："anime"、"3d_animation"、"day"、"cyberpunk"、"comic"，如非必要可不传
motion_mode	否	string	动作模式，默认 "normal"；可选 "fast"（仅支持 5 秒，1080p 不支持 "fast"）
duration	是	integer	生成时长（秒），可选 5、8；1080p 模式仅支持 5
quality	是	string	分辨率质量，可选 "360p"(Turbo)、"540p"、"720p"、"1080p"
seed	否	integer	随机种子，32 位整数，范围 0–2147483647
aspect_ratio	否	string	画面比例，可选 "16:9"、"9:16"、"1:1" 等（若不传则默认为平台设置）
water_mark	否	boolean	是否添加水印，默认 false

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

通过 “获取视频生成状态” 接口，轮询 video_id，检查状态码变化；

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

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