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

# Wan2.7

> 使用 Wan2.7 系列完成文生视频、图生视频和多模态参考生视频。

Wan2.7 是一个视频生成模型系列，通过三个 AnyFast 模型 ID 提供文生视频、图生视频和参考生视频能力：`wan2.7-t2v`、`wan2.7-i2v` 和 `wan2.7-r2v`。

<Info>
  对于特定内容请求，请在 `Direct` 资源组中选择对应的 `-nsfw` 模型：`wan2.7-t2v-nsfw`、`wan2.7-i2v-nsfw` 或 `wan2.7-r2v-nsfw`，并将 `parameters.prompt_extend` 设为 `false`。
</Info>

请选择要使用的能力。每个能力 Tab 都包含完整的上游示例、请求方式、媒体限制和输出控制说明。

<Tabs sync={false}>
  <Tab title="文生视频">
    Wan2.7 T2V 根据文本生成视频和同步音频。请使用对应的 AnyFast 模型 ID `wan2.7-t2v`，向 `POST https://www.anyfast.ai/v1/video/generations` 发起请求。

    <Info>
      如需生成特定内容，请在 `Direct` 资源组下选择 `wan2.7-t2v-nsfw`，并将 `parameters.prompt_extend` 设为 `false`。`-nsfw` 模型 ID 及此设置均为 AnyFast 平台要求。
    </Info>

    ## 核心能力

    | 能力    | 行为                                     |
    | ----- | -------------------------------------- |
    | 文生视频  | 根据中文或英文提示词生成视频                         |
    | 自动音频  | 未传 `input.audio_url` 时，自动生成匹配的对白、音乐和音效 |
    | 自定义音频 | 接收一个公开可访问的 WAV 或 MP3 URL，并让画面与音频对齐     |
    | 多镜头叙事 | 直接在提示词中描述镜头变化                          |
    | 输出    | 720P 或 1080P、2–15 秒、30 fps MP4（H.264）  |

    Wan2.7 不使用 `shot_type`。请把每个镜头、转场和运镜要求直接写入 `input.prompt`。

    ## 能力示例

    <Info>
      以下素材来自阿里云官方上游示例，仅用于展示模型能力，并非通过 AnyFast 复现的结果。
    </Info>

    <Tabs sync={false}>
      <Tab title="自动音频">
        省略 `input.audio_url` 即可让模型生成同步音频。如需多镜头结果，请在提示词中描述镜头顺序和转场。

        <Frame caption="上游 Wan2.7 自动音频输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/uhvcfr/wengtingyu_Wan2.7_evaluation_evaluation_results-10.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>
      </Tab>

      <Tab title="自定义音频">
        将 `input.audio_url` 设为一个公开可访问的 WAV 或 MP3 文件。音频长于目标视频时会被截断；音频较短时，视频剩余部分保持静音。

        <Card title="上游自定义音频输入" icon="volume-high" href="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250929/ajcbjm/%E7%8B%90%E7%8B%B8.mp3">
          打开上游示例使用的 MP3。
        </Card>

        <Frame caption="上游自定义音频输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250929/aclbbv/38513c71-5190-48e1-9f3b-37c5e9f01030.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>
      </Tab>
    </Tabs>

    ## 创建任务

    <Tabs sync={false}>
      <Tab title="自动音频">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-t2v",
            "input": {
              "prompt": "镜头1：猎豹在阳光下的草原上追逐羚羊，羚羊穿过高草。镜头2：切换到猎豹身旁的低机位跟拍，伴随沉重脚步声和呼啸风声。镜头3：羚羊跃过山脊逃脱，镜头升至宽阔航拍视角。",
              "negative_prompt": "模糊，字幕，肢体畸形"
            },
            "parameters": {
              "resolution": "1080P",
              "ratio": "16:9",
              "duration": 15,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>

      <Tab title="自定义音频">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-t2v",
            "input": {
              "prompt": "一只红狐在积雪覆盖的松林中小跑，动作与输入音频自然同步。电影感侧向跟拍，柔和冬日光线。",
              "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250929/ajcbjm/%E7%8B%90%E7%8B%B8.mp3"
            },
            "parameters": {
              "resolution": "1080P",
              "ratio": "16:9",
              "duration": 8,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>
    </Tabs>

    创建接口为异步接口。请保存返回的任务 ID，并轮询 [Wan2 任务查询接口](/zh/guides/model-api/alibaba/wan2-task-query)。

    ## 控制输出

    | 参数                         | 行为                                              |
    | -------------------------- | ----------------------------------------------- |
    | `parameters.resolution`    | 默认为 `1080P`，也支持 `720P`                          |
    | `parameters.ratio`         | 默认为 `16:9`，还支持 `9:16`、`1:1`、`4:3`、`3:4`         |
    | `parameters.duration`      | 2–15 秒的整数，默认为 `5`                               |
    | `parameters.prompt_extend` | 默认为 `true`，用于改写和扩展提示词                           |
    | `parameters.watermark`     | 默认为 `false`；设为 `true` 会在右下角添加 `AI Generated` 水印 |
    | `parameters.seed`          | `0` 到 `2147483647` 的整数；复用相同种子可提高可复现性，但不保证结果完全一致 |

    `parameters.resolution` 与 `parameters.ratio` 共同决定实际输出尺寸：

    | 分辨率     |    `16:9` |    `9:16` |     `1:1` |     `4:3` |     `3:4` |
    | ------- | --------: | --------: | --------: | --------: | --------: |
    | `720P`  |  1280×720 |  720×1280 |   960×960 |  1104×832 |  832×1104 |
    | `1080P` | 1920×1080 | 1080×1920 | 1440×1440 | 1648×1248 | 1248×1648 |

    所有生成视频均为采用 H.264 编码的 30 fps MP4 文件。

    ## 输入与文本限制

    以下限制依据 [阿里云 Wan2.7 文生视频 API 参考](https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference)。

    | 输入                      | 要求                                                |
    | ----------------------- | ------------------------------------------------- |
    | `input.prompt`          | 必填，最多 5,000 个字符。每个汉字、字母、数字、空格和标点均计 1 个字符，超出部分自动截断 |
    | `input.negative_prompt` | 可选，最多 500 个字符，超出部分自动截断                            |
    | `input.audio_url`       | 可选的公开 WAV 或 MP3 URL；2–30 秒，最大 15 MB               |

    自定义音频长于 `parameters.duration` 时，仅使用与目标时长对应的开头部分；较短时，生成视频剩余部分保持静音。若希望 Wan2.7 生成完整音轨，请省略 `audio_url`。

    ## 提示词建议

    * 描述主体、动作、环境、视觉风格、运镜、时间节奏、对白、音乐和关键音效。
    * 如需多个镜头，请在提示词中按“镜头1”“镜头2”“镜头3”组织顺序，并描述镜头间转场。
    * 不要向 Wan2.7 T2V 传入 `shot_type`。
    * 由于提示词和负向提示词超出上限后会自动截断，请把最重要的约束放在前面。

    ## 查询并保存结果

    轮询 `GET https://www.anyfast.ai/v1/video/generations/{TASK_ID}`，直到 AnyFast 外层 `data.status` 变为 `SUCCESS` 或 `FAILURE`。等待状态包括 `NOT_START`、`QUEUED` 和 `IN_PROGRESS`；`data.progress` 是百分比字符串，例如 `"0%"` 或 `"100%"`。

    嵌套的 `data.data.output.task_status` 是上游服务商状态。控制轮询逻辑时，不要用它替代 AnyFast 外层状态。完整响应结构请参阅 [Wan2 任务查询](/zh/guides/model-api/alibaba/wan2-task-query)。

    * 任务创建后可查询 24 小时。
    * 成功结果 URL 的有效期为 24 小时，请及时下载或转存视频。

    <Card title="Wan2.7 文生视频 API 参考" icon="code" href="/zh/api-reference/model-api/alibaba/wan2.7-t2v">
      查看完整请求和响应 Schema。
    </Card>
  </Tab>

  <Tab title="图生视频">
    Wan2.7 I2V 可根据首帧图片、首尾帧图片对或起始视频片段创建视频。请使用对应的 AnyFast 模型 ID `wan2.7-i2v`，向 `POST https://www.anyfast.ai/v1/video/generations` 发起请求。

    <Info>
      如需生成特定内容，请在 `Direct` 资源组下选择 `wan2.7-i2v-nsfw`，并将 `parameters.prompt_extend` 设为 `false`。`-nsfw` 模型 ID 及此设置均为 AnyFast 平台要求。
    </Info>

    ## 核心能力

    | 工作流   | `input.media`                                    | 主要行为                 |
    | ----- | ------------------------------------------------ | -------------------- |
    | 首帧动画  | `first_frame`，可选配 `driving_audio`                | 动画化一张起始图片；音频可驱动动作和声音 |
    | 首尾帧控制 | `first_frame` + `last_frame`，可选配 `driving_audio` | 生成两张图片之间的视觉过渡        |
    | 视频续写  | `first_clip`，可选配 `last_frame`                    | 延长输入片段，并可用一张图片控制结尾   |

    每种媒体类型最多出现一次。输出宽高比跟随 `first_frame` 或 `first_clip`，此模型不单独选择输出宽高比。

    ## 能力示例

    <Info>
      以下素材来自阿里云官方上游示例，用于展示模型输入和输出，并非通过 AnyFast 复现的结果。
    </Info>

    <Tabs sync={false}>
      <Tab title="首帧动画">
        使用一个 `first_frame` 制作动画。如果面部动作、表演或节奏需要跟随指定音轨，可再添加一个 `driving_audio`。

        <Frame caption="上游首帧输入">
          <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png" alt="上游 Wan2.7 首帧示例使用的涂鸦说唱人物图片" className="w-full aspect-video object-contain object-center" />
        </Frame>

        <Card title="上游驱动音频输入" icon="volume-high" href="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/jwfapw/rap.mp3">
          打开上游首帧示例使用的驱动 MP3。
        </Card>
      </Tab>

      <Tab title="首尾帧控制">
        分别提供一个 `first_frame` 和一个 `last_frame`，并在提示词中描述连接两种构图的动作和过渡。

        <Columns cols={2}>
          <Frame caption="上游首帧输入">
            <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/welyei/wan2.7-i2v-first-frame.webp" alt="上游 Wan2.7 关键帧示例的首帧" className="w-full aspect-video object-contain object-center" />
          </Frame>

          <Frame caption="上游尾帧输入">
            <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/zongha/wan2.7-i2v-last-frame.webp" alt="上游 Wan2.7 关键帧示例的尾帧" className="w-full aspect-video object-contain object-center" />
          </Frame>
        </Columns>

        <Frame caption="上游首尾帧输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/ofjdke/wan2.7-i2v-keyframe-result.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>
      </Tab>

      <Tab title="视频续写">
        提供一个 `first_clip`，还可添加一个 `last_frame` 控制结尾。请求中的 `duration` 表示包含输入片段在内的总时长。

        <Columns cols={2}>
          <Frame caption="上游起始片段输入">
            <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/cqcbkw/wan2.7-i2v-video-continuation.mp4">
              你的浏览器不支持视频播放。
            </video>
          </Frame>

          <Frame caption="上游尾帧输入">
            <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/mrwahg/wan2.7-i2v-video-continuation.webp" alt="上游 Wan2.7 视频续写示例的结尾帧" className="w-full aspect-video object-contain object-center" />
          </Frame>
        </Columns>

        <Frame caption="上游视频续写输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/jxkfuw/wan2.7-i2v-video-continuation-result.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>
      </Tab>
    </Tabs>

    ## 创建任务

    <Tabs sync={false}>
      <Tab title="首帧动画">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-i2v",
            "input": {
              "prompt": "涂鸦人物苏醒，在铁路桥下进行充满活力的说唱表演。口型自然，镜头平稳向前推进。",
              "media": [
                {
                  "type": "first_frame",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
                },
                {
                  "type": "driving_audio",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/jwfapw/rap.mp3"
                }
              ]
            },
            "parameters": {
              "resolution": "1080P",
              "duration": 8,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>

      <Tab title="首尾帧控制">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-i2v",
            "input": {
              "prompt": "镜头向前滑动，画面从首帧构图平滑变化到尾帧构图，保持主体和光线一致。",
              "media": [
                {
                  "type": "first_frame",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/welyei/wan2.7-i2v-first-frame.webp"
                },
                {
                  "type": "last_frame",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/zongha/wan2.7-i2v-last-frame.webp"
                }
              ]
            },
            "parameters": {
              "resolution": "1080P",
              "duration": 8,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>

      <Tab title="视频续写">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-i2v",
            "input": {
              "prompt": "自然延续镜头运动和人物动作，随后以一致的色彩和光线平稳过渡到指定尾帧。",
              "media": [
                {
                  "type": "first_clip",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/cqcbkw/wan2.7-i2v-video-continuation.mp4"
                },
                {
                  "type": "last_frame",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/mrwahg/wan2.7-i2v-video-continuation.webp"
                }
              ]
            },
            "parameters": {
              "resolution": "1080P",
              "duration": 12,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>
    </Tabs>

    创建接口为异步接口。请保存返回的任务 ID，并轮询 [Wan2 任务查询接口](/zh/guides/model-api/alibaba/wan2-task-query)。

    ## 合法媒体组合

    Wan2.7 I2V 仅接受以下六种组合。表中每种类型最多出现一次。

    | 工作流        | `input.media` 精确组合                             |
    | ---------- | ---------------------------------------------- |
    | 首帧动画       | `first_frame`                                  |
    | 首帧动画 + 音频  | `first_frame` + `driving_audio`                |
    | 首尾帧控制      | `first_frame` + `last_frame`                   |
    | 首尾帧控制 + 音频 | `first_frame` + `last_frame` + `driving_audio` |
    | 视频续写       | `first_clip`                                   |
    | 视频续写 + 尾帧  | `first_clip` + `last_frame`                    |

    不要混用 `first_clip` 与 `first_frame` 或 `driving_audio`，也不要重复传入同一种媒体类型。

    ## 输入与文本限制

    以下限制依据 [阿里云 Wan2.7 图生视频 API 参考](https://www.alibabacloud.com/help/en/model-studio/image-to-video-general-api-reference)。

    ### 图片

    以下规则适用于 `first_frame` 和 `last_frame`。

    | 属性   | 要求                                   |
    | ---- | ------------------------------------ |
    | 输入方式 | 公开 URL 或 Base64 数据 URL               |
    | 格式   | JPEG、JPG、不含 Alpha 通道的 PNG、BMP 或 WEBP |
    | 尺寸   | 每边 240–8,000 px                      |
    | 宽高比  | 1:8 到 8:1                            |
    | 文件大小 | 每张最大 20 MB                           |

    ### 驱动音频

    | 属性   | 要求        |
    | ---- | --------- |
    | 输入方式 | 公开 URL    |
    | 格式   | WAV 或 MP3 |
    | 时长   | 2–30 秒    |
    | 文件大小 | 最大 15 MB  |

    音频长于目标视频时会被截断；较短时，视频剩余部分保持静音。

    ### 起始片段

    | 属性   | 要求              |
    | ---- | --------------- |
    | 输入方式 | 公开 URL          |
    | 格式   | MP4 或 MOV       |
    | 时长   | 2–10 秒          |
    | 尺寸   | 每边 240–4,096 px |
    | 宽高比  | 1:8 到 8:1       |
    | 文件大小 | 最大 100 MB       |

    ### 文本

    * 存在合法媒体时，`input.prompt` 可选。最多 5,000 个字符；每个汉字、字母、数字、空格和标点均计 1 个字符，超出部分自动截断。
    * `input.negative_prompt` 最多 500 个字符，超出部分自动截断。

    ## 控制输出

    | 参数                         | 行为                                              |
    | -------------------------- | ----------------------------------------------- |
    | `parameters.resolution`    | 默认为 `1080P`，也支持 `720P`                          |
    | `parameters.duration`      | 2–15 秒的输出总时长，默认为 `5`                            |
    | `parameters.prompt_extend` | 默认为 `true`，用于改写和扩展提示词                           |
    | `parameters.watermark`     | 默认为 `false`；设为 `true` 会在右下角添加 `AI Generated` 水印 |
    | `parameters.seed`          | `0` 到 `2147483647` 的整数；复用相同种子可提高可复现性，但不保证结果完全一致 |

    对于视频续写，`duration` 包含完整输入片段和新生成的续写部分，应至少与输入片段等长。输出宽高比跟随首帧或起始片段。所有输出均为采用 H.264 编码的 30 fps MP4 文件。

    ## 提示词建议

    * 首帧动画应描述输入图片之后发生的动作，包括主体动作、运镜、节奏、对白和声音。
    * 首尾帧生成应描述主体和镜头如何在两种构图之间移动。
    * 视频续写只需描述输入片段之后的动作，以及如何到达尾帧（如有）。
    * 提示词和负向提示词超出上限后会自动截断，请把关键要求放在前面。

    ## 查询并保存结果

    轮询 `GET https://www.anyfast.ai/v1/video/generations/{TASK_ID}`，直到 AnyFast 外层 `data.status` 变为 `SUCCESS` 或 `FAILURE`。等待状态包括 `NOT_START`、`QUEUED` 和 `IN_PROGRESS`；`data.progress` 是百分比字符串，例如 `"0%"` 或 `"100%"`。

    嵌套的 `data.data.output.task_status` 是上游服务商状态。控制轮询逻辑时，不要用它替代 AnyFast 外层状态。完整响应结构请参阅 [Wan2 任务查询](/zh/guides/model-api/alibaba/wan2-task-query)。

    * 任务创建后可查询 24 小时。
    * 成功结果 URL 的有效期为 24 小时，请及时下载或转存视频。

    <Card title="Wan2.7 图生视频 API 参考" icon="code" href="/zh/api-reference/model-api/alibaba/wan2.7-i2v">
      查看完整请求和响应 Schema。
    </Card>
  </Tab>

  <Tab title="参考生视频">
    Wan2.7 R2V 根据参考图片和视频生成新视频，并保持主体、物体、场景、动作和声音的一致性。请使用对应的 AnyFast 模型 ID `wan2.7-r2v`，向 `POST https://www.anyfast.ai/v1/video/generations` 发起请求。

    <Info>
      如需生成特定内容，请在 `Direct` 资源组下选择 `wan2.7-r2v-nsfw`，并将 `parameters.prompt_extend` 设为 `false`。`-nsfw` 模型 ID 及此设置均为 AnyFast 平台要求。
    </Info>

    ## 核心能力

    | 能力     | 行为                                                    |
    | ------ | ----------------------------------------------------- |
    | 混合主体参考 | 组合 `reference_image` 和 `reference_video`，参考素材合计最多 5 个 |
    | 声音保持   | 在参考图片或视频上附加 `reference_voice`                         |
    | 多格故事板  | 使用一张包含多个分镜格的图片描述镜头序列                                  |
    | 首帧控制   | 在参考素材之外最多添加一个 `first_frame`，锁定开场构图                    |
    | 输出     | 720P 或 1080P、30 fps MP4（H.264）                        |

    请求必须至少包含一个 `reference_image` 或 `reference_video`。图片和视频按各自类型中的出现顺序独立编号，请在提示词中用 `Image 1`、`Image 2`、`Video 1` 等名称引用。

    ## 能力示例

    <Info>
      以下素材来自阿里云官方上游示例，用于展示模型输入和输出，并非通过 AnyFast 复现的结果。
    </Info>

    <Tabs sync={false}>
      <Tab title="多主体与声音">
        组合主体视频、主体图片、背景图片和声音样本。通过 `reference_voice` 将每个声音 URL 绑定到对应参考项。

        <Accordion title="查看上游参考输入">
          <Columns cols={2}>
            <Frame caption="Video 1 — 人物与动作">
              <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4">
                你的浏览器不支持视频播放。
              </video>
            </Frame>

            <Frame caption="Image 1 — 第二个人物">
              <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg" alt="上游 Wan2.7 R2V 示例中的男孩人物参考" className="w-full aspect-video object-contain object-center" />
            </Frame>

            <Frame caption="Image 2 — 背景">
              <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg" alt="上游 Wan2.7 R2V 示例中的锈墙背景参考" className="w-full aspect-video object-contain object-center" />
            </Frame>
          </Columns>

          <CardGroup cols={2}>
            <Card title="Video 1 声音" icon="volume-high" href="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3">
              打开绑定到 Video 1 的上游声音样本。
            </Card>

            <Card title="Image 1 声音" icon="volume-high" href="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3">
              打开绑定到 Image 1 的上游声音样本。
            </Card>
          </CardGroup>
        </Accordion>

        <Frame caption="上游多主体输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/jxpvnl/Wan_Video_Reference_result-en.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>
      </Tab>

      <Tab title="多格故事板">
        使用一个包含多个分镜格的 `reference_image`。在提示词中描述预期顺序、主体动作、运镜变化和转场；不要把每个分镜格作为独立参考图上传。

        <Frame caption="上游单图故事板输入">
          <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/wgjaxy/banana_storyboard_00000020.png" alt="上游 Wan2.7 R2V 示例使用的香蕉多格故事板" className="w-full aspect-video object-contain object-center" />
        </Frame>

        <Frame caption="上游故事板输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/initxb/banana_storyboard-result.mp4banana_storyboard-result.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>
      </Tab>

      <Tab title="首帧联合控制">
        在必需的参考媒体之外添加一个 `first_frame`。首帧固定开场构图，参考图片或视频继续提供主体身份和外观。

        <Columns cols={3}>
          <Frame caption="上游首帧输入">
            <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/ixwovg/wan2.7-r2v-first-frame.webp" alt="上游 Wan2.7 R2V 示例中的行星开场构图" className="w-full aspect-video object-contain object-center" />
          </Frame>

          <Frame caption="Image 1 — 主体">
            <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/fkltfw/wan2.7-r2v-image-qq.webp" alt="上游首帧 R2V 示例中的第一个主体参考" className="w-full aspect-video object-contain object-center" />
          </Frame>

          <Frame caption="Image 2 — 物体">
            <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/kxkbsv/wan2.7-r2v-image-ob.webp" alt="上游首帧 R2V 示例中的物体参考" className="w-full aspect-video object-contain object-center" />
          </Frame>
        </Columns>

        <Frame caption="上游首帧联合控制输出示例">
          <video controls playsInline preload="none" className="w-full aspect-video rounded-xl object-contain" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260416/atkujm/wan2.7-r2v-firstframe-result.mp4">
            你的浏览器不支持视频播放。
          </video>
        </Frame>

        存在 `first_frame` 时，`parameters.ratio` 被忽略，输出宽高比跟随首帧。
      </Tab>
    </Tabs>

    ## 创建任务

    <Tabs sync={false}>
      <Tab title="多主体与声音">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-r2v",
            "input": {
              "prompt": "Video 1 从画面左侧深处走来。随后镜头切到 Image 1 的特写。Video 1 靠在 Image 2 中右侧的锈墙上，听到脚步声后缓慢转头。看到 Image 1 后，Video 1 说：你为什么还是来了？Image 1 回答：我们谈谈。",
              "media": [
                {
                  "type": "reference_video",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4",
                  "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3"
                },
                {
                  "type": "reference_image",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg",
                  "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3"
                },
                {
                  "type": "reference_image",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg"
                }
              ]
            },
            "parameters": {
              "resolution": "1080P",
              "ratio": "16:9",
              "duration": 8,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>

      <Tab title="多格故事板">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-r2v",
            "input": {
              "prompt": "将 Image 1 作为故事板。镜头1：按照第一格建立香蕉角色和场景。镜头2：平滑运镜，延续中间几格所示的动作。镜头3：以最后一格的构图结束，并保持角色设计一致。",
              "media": [{
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/wgjaxy/banana_storyboard_00000020.png"
              }]
            },
            "parameters": {
              "resolution": "1080P",
              "ratio": "16:9",
              "duration": 12,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>

      <Tab title="首帧联合控制">
        ```bash cURL theme={null}
        curl --request POST \
          --url https://www.anyfast.ai/v1/video/generations \
          --header 'Authorization: Bearer YOUR_API_KEY' \
          --header 'Content-Type: application/json' \
          --data '{
            "model": "wan2.7-r2v",
            "input": {
              "prompt": "俯视镜头拍摄一颗蓝色星球。镜头逐渐向地表推进，切换到 Image 1 的特写；Image 1 手拿 Image 2 并吃下它，同时说：为什么没有人来陪我玩？",
              "media": [
                {
                  "type": "first_frame",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/ixwovg/wan2.7-r2v-first-frame.webp"
                },
                {
                  "type": "reference_image",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/fkltfw/wan2.7-r2v-image-qq.webp"
                },
                {
                  "type": "reference_image",
                  "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/kxkbsv/wan2.7-r2v-image-ob.webp"
                }
              ]
            },
            "parameters": {
              "resolution": "1080P",
              "duration": 8,
              "prompt_extend": true,
              "watermark": false,
              "seed": 42
            }
          }'
        ```
      </Tab>
    </Tabs>

    创建接口为异步接口。请保存返回的任务 ID，并轮询 [Wan2 任务查询接口](/zh/guides/model-api/alibaba/wan2-task-query)。

    ## 参考素材编号方式

    参考图片和参考视频按照各自在 `input.media` 中的出现顺序独立编号。

    * 第一个 `reference_image` 是 `Image 1`，即使它前面已有 `reference_video`。
    * 第一个 `reference_video` 是 `Video 1`。
    * `first_frame` 不会变成 `Image 1`，也不计入最多 5 个参考图片与视频的合计数量。
    * 仅把 `reference_voice` 绑定到需要保持该声音的 `reference_image` 或 `reference_video`。

    ## 输入与文本限制

    以下限制依据 [阿里云 Wan2.7 参考生视频 API 参考](https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference)。

    ### 图片

    以下规则适用于 `reference_image` 和 `first_frame`。

    | 属性   | 要求                                   |
    | ---- | ------------------------------------ |
    | 输入方式 | 公开 URL 或 Base64 数据 URL               |
    | 格式   | JPEG、JPG、不含 Alpha 通道的 PNG、BMP 或 WEBP |
    | 尺寸   | 每边 240–8,000 px                      |
    | 宽高比  | 1:8 到 8:1                            |
    | 文件大小 | 每张最大 20 MB                           |

    ### 参考视频

    | 属性   | 要求              |
    | ---- | --------------- |
    | 输入方式 | 公开 URL          |
    | 格式   | MP4 或 MOV       |
    | 时长   | 1–30 秒          |
    | 尺寸   | 每边 240–4,096 px |
    | 宽高比  | 1:8 到 8:1       |
    | 文件大小 | 每个最大 100 MB     |

    ### 参考声音

    | 属性   | 要求                         |
    | ---- | -------------------------- |
    | 输入方式 | `reference_voice` 中的公开 URL |
    | 格式   | WAV 或 MP3                  |
    | 时长   | 1–10 秒                     |
    | 文件大小 | 最大 15 MB                   |

    `reference_voice` 控制声音特征，不决定对白文本。如果参考视频自带音频且未提供 `reference_voice`，将使用原音频；显式设置 `reference_voice` 时则以它为准。

    ### 数量与文本

    * 至少包含一个 `reference_image` 或 `reference_video`，二者合计不得超过 5 个。
    * 在必需的参考媒体之外，最多添加一个 `first_frame`。
    * `input.prompt` 必填，最多 5,000 个字符。每个汉字、字母、数字、空格和标点均计 1 个字符，超出部分自动截断。
    * `input.negative_prompt` 最多 500 个字符，超出部分自动截断。

    ## 控制输出

    | 参数                         | 行为                                              |
    | -------------------------- | ----------------------------------------------- |
    | `parameters.resolution`    | 默认为 `1080P`，也支持 `720P`                          |
    | `parameters.ratio`         | 默认为 `16:9`，还支持 `9:16`、`1:1`、`4:3`、`3:4`         |
    | `parameters.duration`      | 默认为 `5`，范围取决于是否存在参考视频                           |
    | `parameters.prompt_extend` | 默认为 `true`，用于改写和扩展提示词                           |
    | `parameters.watermark`     | 默认为 `false`；设为 `true` 会在右下角添加 `AI Generated` 水印 |
    | `parameters.seed`          | `0` 到 `2147483647` 的整数；复用相同种子可提高可复现性，但不保证结果完全一致 |

    请求中只要包含任何 `reference_video`，`duration` 就必须为 2–10 秒的整数；仅使用图片时为 2–15 秒。存在 `first_frame` 时，`ratio` 被忽略，输出宽高比跟随首帧。所有输出均为采用 H.264 编码的 30 fps MP4 文件。

    <Info>
      R2V 查询成功后，`usage.duration` 是上游报告的计费总时长，等于 `usage.input_video_duration + usage.output_video_duration`。参考视频输入的总计费时长上限为 5 秒；存在 `N` 个参考视频时，每个视频最多计入 `5 / N` 秒，因此 `usage.input_video_duration` 可能短于素材原始时长。对账时请以响应中的 usage 字段为准。
    </Info>

    ## 提示词建议

    * 说明每个 `Image N` 和 `Video N` 提供的内容：身份、服装、物体、场景、动作、运镜或对白。
    * 把每句对白写在说话者的参考标签之后，以便应用正确的 `reference_voice`。
    * 多格故事板仅使用一张故事板图片，并把各格顺序写成明确的镜头和转场。
    * 提示词和负向提示词超出上限后会自动截断，请把关键要求放在前面。

    ## 查询并保存结果

    轮询 `GET https://www.anyfast.ai/v1/video/generations/{TASK_ID}`，直到 AnyFast 外层 `data.status` 变为 `SUCCESS` 或 `FAILURE`。等待状态包括 `NOT_START`、`QUEUED` 和 `IN_PROGRESS`；`data.progress` 是百分比字符串，例如 `"0%"` 或 `"100%"`。

    嵌套的 `data.data.output.task_status` 是上游服务商状态。控制轮询逻辑时，不要用它替代 AnyFast 外层状态。完整响应结构请参阅 [Wan2 任务查询](/zh/guides/model-api/alibaba/wan2-task-query)。

    * 任务创建后可查询 24 小时。
    * 成功结果 URL 的有效期为 24 小时，请及时下载或转存视频。

    <Card title="Wan2.7 参考生视频 API 参考" icon="code" href="/zh/api-reference/model-api/alibaba/wan2.7-r2v">
      查看完整请求和响应 Schema。
    </Card>
  </Tab>
</Tabs>

<script src="/public/feedback.js" />