> ## 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 R2V

> 通过 Wan2.7 R2V 使用参考图片、视频、音色和可选首帧生成一致的视频。

Wan2.7 R2V 是阿里云万相参考生视频模型，通过 AnyFast 异步视频 API 提供服务。它可利用参考图片和视频，在多个镜头中保持人物、物体、场景和音色的一致性。

`R2V` 表示**参考素材生成视频（reference-to-video）**。参考素材用于定义外观和身份；可选的 `first_frame` 则单独控制视频首帧。

## 核心能力

* **混合参考** - 最多组合 5 个参考图片和参考视频
* **首帧控制** - 最多额外传入 1 个 `first_frame`
* **音色参考** - 为参考图片或视频添加 `reference_voice`
* **提示词引用** - 使用 `Image 1`、`Image 2`、`Video 1`、`Video 2` 指代素材
* **分辨率** - `720P` 或 `1080P`
* **时长** - 包含参考视频时为 2-10 秒；不包含参考视频时为 2-15 秒
* **输出格式** - 30 fps MP4 视频

## 快速示例

```bash cURL theme={null}
curl https://www.anyfast.ai/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "wan2.7-r2v",
    "input": {
      "prompt": "Image 1 中的人物走过 Video 1 中的街道，然后看向镜头。",
      "media": [
        {
          "type": "reference_image",
          "url": "https://example.com/character.png"
        },
        {
          "type": "reference_video",
          "url": "https://example.com/street.mp4"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "prompt_extend": true,
      "watermark": false
    }
  }'
```

<Tip>
  图片和视频分别按其在 `input.media` 中的顺序编号。提示词中请使用准确的 `Image N` 和 `Video N`。同类素材只有一个时，也可以写“参考图片”或“参考视频”。
</Tip>

## 如何开启 NSFW 功能

1. 创建 API 令牌时选择 `Special-Ns` 资源分组。
2. 将 `parameters.prompt_extend` 设置为 `false`，该参数默认为 `true`。

## 输入限制

* 参考图片：JPEG/JPG/PNG/BMP/WEBP；宽高 240-8,000 px；宽高比 1:8 到 8:1；最大 20 MB；支持 URL 或 Base64 Data URL
* 参考视频：MP4/MOV；1-30 秒；宽高 240-4,096 px；宽高比 1:8 到 8:1；最大 100 MB；使用公开 URL
* 参考音色：WAV/MP3；1-10 秒；最大 15 MB；使用公开 URL
* 素材数量：至少传入一个参考图片或视频；参考图片与参考视频合计不超过 5 个

## 参数说明

| 参数                              | 类型      | 必填 | 说明                                                     |
| ------------------------------- | ------- | -- | ------------------------------------------------------ |
| `model`                         | string  | 是  | 必须为 `wan2.7-r2v`                                       |
| `input.prompt`                  | string  | 是  | 视频描述，最多 5,000 个字符                                      |
| `input.negative_prompt`         | string  | 否  | 不希望出现的内容，最多 500 个字符                                    |
| `input.media`                   | array   | 是  | 参考素材以及可选首帧                                             |
| `input.media[].type`            | string  | 是  | `reference_image`、`reference_video` 或 `first_frame`    |
| `input.media[].url`             | string  | 是  | 图片或视频地址；图片还支持 Base64 Data URL                          |
| `input.media[].reference_voice` | string  | 否  | 作为主体音色参考的公开 WAV/MP3 URL                                |
| `parameters.resolution`         | string  | 否  | `720P` 或 `1080P`，默认 `1080P`                            |
| `parameters.ratio`              | string  | 否  | `16:9`、`9:16`、`1:1`、`4:3` 或 `3:4`；传入 `first_frame` 时忽略 |
| `parameters.duration`           | integer | 否  | 默认 `5`；范围取决于是否包含参考视频                                   |
| `parameters.prompt_extend`      | boolean | 否  | 是否改写并扩展提示词，默认 `true`                                   |
| `parameters.watermark`          | boolean | 否  | 是否添加“AI 生成”水印，默认 `false`                               |
| `parameters.seed`               | integer | 否  | `[0, 2147483647]` 范围内的随机种子                             |

<CardGroup cols={2}>
  <Card title="API 参考" icon="code" href="/zh/api-reference/model-api/alibaba/wan2.7-r2v">查看完整请求参数。</Card>
  <Card title="任务查询" icon="magnifying-glass" href="/zh/guides/model-api/alibaba/wan2-task-query">轮询任务并获取结果链接。</Card>
</CardGroup>

## 官方参考

参阅[阿里云百炼 Wan 参考生视频 API 参考](https://www.alibabacloud.com/help/zh/model-studio/wan-video-to-video-api-reference)。

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