> ## 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.7 视频编辑

万相 Wan 2.7 视频编辑模型，支持多模态输入（文本/图像/视频），可完成指令编辑和视频迁移任务。支持720P和1080P分辨率，时长2\~10秒，按秒计费。输出默认包含音频。

<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="seed" type="integer">
  随机数种子，用于提升生成结果的可复现性。取值范围\[0, 2147483647]。

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

<ParamField body="ratio" type="string">
  生成视频的宽高比。不传则以输入视频的宽高比生成近似比例的视频。720P支持：16:9(1280*720)、9:16(720*1280)、1:1(960*960)、4:3(1104*832)、3:4(832*1104)。1080P支持：16:9(1920*1080)、9:16(1080*1920)、1:1(1440*1440)、4:3(1648*1248)、3:4(1248*1648)。

  可选值：`16:9`, `9:16`, `1:1`, `4:3`, `3:4`
</ParamField>

<ParamField body="prompt" type="string">
  文本提示词，用于描述对视频的编辑操作。支持中英文，最多5000个字符。例如「将整个画面转换为黏土风格」「将视频中女孩的衣服替换为图片中的衣服」。

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

<ParamField body="duration" type="integer" default={0}>
  生成视频的时长，单位为秒。默认值为0，代表直接使用输入视频的时长。当传入\[2,10]之间的整数时，系统从原视频的0秒起截取至指定时长。仅在需要截断视频时才需配置。

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

<ParamField body="video_url" type="string" required={true}>
  待编辑的视频URL。格式支持mp4、mov。时长2~~10秒，分辨率宽高范围\[240,4096]像素，宽高比1:8~~8:1，文件大小不超过100MB。
</ParamField>

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

<ParamField body="resolution" type="string" default="1080P">
  输出视频分辨率档位，影响费用（1080P > 720P）。视频宽高比与输入素材保持一致（除非指定ratio参数）。

  可选值：`720P`, `1080P`
</ParamField>

<ParamField body="audio_setting" type="string" default="auto">
  视频声音设置。auto：模型根据prompt内容智能判断，若提示词涉及声音描述可能重新生成音频，否则可能保留原声。origin：强制保留输入视频的原声。

  可选值：`auto`, `origin`
</ParamField>

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

<ParamField body="negative_prompt" type="string">
  反向提示词，用于描述不希望在视频画面中出现的内容。支持中英文，最多500个字符。

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

<ParamField body="reference_image_url" type="string">
  参考图像URL。可用于提供编辑所需的视觉参考（如替换衣物、风格迁移等）。格式支持JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。分辨率宽高范围\[240,8000]像素，宽高比1:8\~8:1，文件大小不超过20MB。最多可传入3张参考图像。
</ParamField>

<ParamField body="reference_image_url_2" type="string">
  第二张参考图像URL，格式限制同reference\_image\_url。
</ParamField>

<ParamField body="reference_image_url_3" type="string">
  第三张参考图像URL，格式限制同reference\_image\_url。
</ParamField>

## 响应

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