> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan 2.5 Preview 文生视频

Wan 2.5 Preview 文生视频模型支持根据文本描述生成高质量视频内容，可生成5秒或10秒的视频。新增音频能力：支持自动配音，也可自定义音频文件。

<Warning>
  本接口支持个人认证及企业认证用户调用。请参见 [实名认证](/support/identity-verification)，完成个人用户认证或企业用户认证，以确保可以正常使用本功能。
</Warning>

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 来检索视频生成结果。
</Tip>

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="input" type="object" required={true}>
  基础输入信息，如提示词等。

  <Expandable title="字段说明" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={true}>
      文本正向提示词。支持中英文，最长 2000 个字符，超出部分自动截断。

      示例值：一只小猫在月光下奔跑。
    </ParamField>

    <ParamField body="negative_prompt" type="string" required={false}>
      反向提示词，用于描述生成视频时需要避开的内容，可实现对画面的规避或限制。

      支持中英文，最长500字符，超出部分自动截断。

      示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。
    </ParamField>

    <ParamField body="audio_url" type="string" required={false}>
      用于视频生成的自定义音频文件URL。使用方法详见音频设置说明。

      音频要求：

      * 格式：wav、mp3。
      * 时长：3\~30秒。
      * 文件大小：不超过15MB。

      超长处理：若音频时长超过目标视频时长（如5秒或10秒），仅保留前5秒或前10秒，其余部分自动舍弃；若音频时长短于视频时长，超出部分为无声视频。例如音频为3秒、视频为5秒，则输出视频前3秒有声音，后2秒为静音。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object" required={false}>
  视频处理参数。

  <Expandable title="字段说明" defaultOpen={true}>
    <ParamField body="size" type="string" required={false}>
      支持480P、720P、1080P分辨率。默认值：`1920*1080`（即1080P）。
      `size`参数用于指定视频输出的分辨率，格式为宽\*高。不同分辨率档位支持的具体值如下：

      **480P档位**：可选分辨率

      * `832*480`：16:9
      * `480*832`：9:16
      * `624*624`：1:1

      **720P档位**：可选分辨率

      * `1280*720`：16:9
      * `720*1280`：9:16
      * `960*960`：1:1
      * `1088*832`：4:3
      * `832*1088`：3:4

      **1080P档位**：可选分辨率

      * `1920*1080`：16:9
      * `1080*1920`：9:16
      * `1440*1440`：1:1
      * `1632*1248`：4:3
      * `1248*1632`：3:4

      <Warning>
        **关于 size 参数的常见误区**：需填写具体分辨率（如 `1280*720`），不能填写比例（如 `1:1`）或档位名称（如 `480P`、`720P`）。
      </Warning>
    </ParamField>

    <ParamField body="duration" type="integer" required={false}>
      输出视频的时长，可选值：`5`秒、`10`秒。

      默认值为`5`。
    </ParamField>

    <ParamField body="prompt_extend" type="bool" required={false}>
      是否开启prompt智能改写。开启后，将使用大模型自动改写输入prompt，对于较短提示词提升生成效果，但处理时长会增加。

      * `true`：默认，开启智能改写
      * `false`：不改写
    </ParamField>

    <ParamField body="watermark" type="bool" required={false}>
      是否添加水印标识，水印位于图片右下角，文案为"AI 生成"。

      * `false`：默认值，不添加水印。
      * `true`：添加水印。
    </ParamField>

    <ParamField body="audio" type="boolean" required={false}>
      是否添加音频。

      参数优先级：audio\_url > audio，仅在 audio\_url 为空时有效。

      * `true`：默认，自动为视频添加配音
      * `false`：不添加音频，输出为静音视频

      示例值：true
    </ParamField>

    <ParamField body="seed" type="integer" required={false}>
      随机数种子，用于控制模型生成内容的随机性。取值范围：\[0, 2147483647]。

      如果不填写，系统自动生成随机种子。若希望生成效果较为稳定一致，可指定相同的seed值。
    </ParamField>
  </Expandable>
</ParamField>

## 返回结果

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>