> ## 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.6 参考生视频

基于 AI 的参考生视频服务，支持通过参考图片或参考视频结合文本提示生成高质量视频内容，提供专业的视频生成能力：开箱即用的 REST 推理 API，最佳性能，无冷启动，价格实惠。

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/docs/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="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={true}>
      文本提示词，用来描述生成视频中期望包含的元素和视觉特点。支持中英文，每个汉字、字母、标点占一个字符，超过部分会自动截断。通过 character1、character2 等标识引用参考角色，每个参考视频或图像仅包含单一角色。

      长度限制：0 - 1500
    </ParamField>

    <ParamField body="reference_urls" type="string[]" required={true}>
      参考图像或参考视频URL数组，用于提取角色形象与音色（如有）。图像数量0～5，视频数量0～3，图像+视频总数不超过5。传入多个参考文件时，按数组顺序定义角色顺序：第1个URL对应character1，第2个对应character2，以此类推。参考视频要求：时长1s～30s，大小不超过100MB。参考图像要求：宽高均在\[240,8000]像素之间，大小不超过20MB。

      数组长度：1 - 5
    </ParamField>

    <ParamField body="negative_prompt" type="string">
      反向提示词，用来描述不希望在视频画面中看到的内容，可以对视频画面进行限制。支持中英文，长度不超过500个字符，超过部分会自动截断。

      长度限制：0 - 500
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object">
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="seed" type="integer">
      随机数种子。取值范围为\[0, 2147483647]。未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。请注意，由于模型生成具有概率性，即使使用相同seed，也不能保证每次生成结果完全一致。

      取值范围：\[0, 2147483647]
    </ParamField>

    <ParamField body="size" type="string" default="1920*1080">
      指定生成视频的分辨率，格式为宽*高。支持720P档位（1280*720/720*1280/960*960/1088*832/832*1088）、1080P档位（1920*1080/1080*1920/1440*1440/1632*1248/1248\*1632）。

      可选值：`1280*720`, `720*1280`, `960*960`, `1088*832`, `832*1088`, `1920*1080`, `1080*1920`, `1440*1440`, `1632*1248`, `1248*1632`
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      生成视频的时长，单位为秒。可选值为5、10，默认值为5。duration直接影响费用，费用=单价（基于分辨率）×时长（秒），请在调用前确认模型价格。

      可选值：`5`, `10`
    </ParamField>

    <ParamField body="shot_type" type="string" default="single">
      视频生成模式。single：默认值，输出单镜头视频；multi：输出多镜头视频。参数优先级：shot\_type > prompt。

      可选值：`single`, `multi`
    </ParamField>

    <ParamField body="watermark" type="boolean" default={false}>
      是否添加水印标识，水印位于视频右下角，文案固定为"AI 生成"。false：默认值，不添加水印；true：添加水印。
    </ParamField>

    <ParamField body="prompt_extend" type="boolean" default={true}>
      是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。true：默认值，开启智能改写；false：不开启智能改写。
    </ParamField>
  </Expandable>
</ParamField>

## 响应

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