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

> 通过 Wan2.7 I2V 使用首帧、首尾帧或起始视频片段生成视频。

Wan2.7 I2V 是阿里云万相图生视频模型，通过 AnyFast 异步视频 API 提供服务。它支持首帧生视频、首尾帧控制、视频续写和音频驱动。

`I2V` 表示**图片生成视频（image-to-video）**。Wan2.7 还支持传入起始视频片段进行续写。

## 支持的素材组合

| 工作流       | `input.media` 类型                               |
| --------- | ---------------------------------------------- |
| 首帧生视频     | `first_frame`                                  |
| 首帧 + 音频   | `first_frame` + `driving_audio`                |
| 首尾帧生视频    | `first_frame` + `last_frame`                   |
| 首尾帧 + 音频  | `first_frame` + `last_frame` + `driving_audio` |
| 视频续写      | `first_clip`                                   |
| 视频续写 + 尾帧 | `first_clip` + `last_frame`                    |

每种素材类型最多出现一次。输出宽高比跟随首帧或起始视频片段。

## 如何开启 NSFW 功能

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

## 快速示例

```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-i2v",
    "input": {
      "prompt": "灯笼逐渐亮起，镜头缓慢向前推进。",
      "media": [
        {
          "type": "first_frame",
          "url": "https://example.com/first-frame.png"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "prompt_extend": true,
      "watermark": false
    }
  }'
```

## 输入限制

* 图片：JPEG/JPG/PNG/BMP/WEBP；宽高 240-8,000 px；宽高比 1:8 到 8:1；最大 20 MB；支持公开 URL 或 Base64 Data URL
* 驱动音频：WAV/MP3；2-30 秒；最大 15 MB；使用公开 URL
* 起始视频：MP4/MOV；2-10 秒；宽高 240-4,096 px；宽高比 1:8 到 8:1；最大 100 MB；使用公开 URL

视频续写时，`parameters.duration` 表示包含输入片段在内的最终视频总时长上限。

## 参数说明

| 参数                         | 类型      | 必填 | 说明                                                        |
| -------------------------- | ------- | -- | --------------------------------------------------------- |
| `model`                    | string  | 是  | 必须为 `wan2.7-i2v`                                          |
| `input.prompt`             | string  | 否  | 动作和场景描述，最多 5,000 个字符                                      |
| `input.negative_prompt`    | string  | 否  | 不希望出现的内容，最多 500 个字符                                       |
| `input.media`              | array   | 是  | 使用上表中的一种有效素材组合                                            |
| `input.media[].type`       | string  | 是  | `first_frame`、`last_frame`、`driving_audio` 或 `first_clip` |
| `input.media[].url`        | string  | 是  | 公开素材 URL；图片还支持 Base64 Data URL                            |
| `parameters.resolution`    | string  | 否  | `720P` 或 `1080P`，默认 `1080P`                               |
| `parameters.duration`      | integer | 否  | 最终总时长 2-15 秒，默认 `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-i2v">查看完整请求参数。</Card>
  <Card title="任务查询" icon="magnifying-glass" href="/zh/guides/model-api/alibaba/wan2-task-query">轮询任务并获取结果链接。</Card>
</CardGroup>

## 官方参考

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

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