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

> 通过 Wan2.7 T2V 根据文字生成带同步音频的 30 fps 视频。

Wan2.7 T2V 是阿里云万相文生视频模型，通过 AnyFast 异步视频 API 提供服务。它可生成带同步音频的 720P 或 1080P MP4 视频，并支持多镜头叙事。

`T2V` 表示**文本生成视频（text-to-video）**：请求只需要文字提示词，不要求输入图片或视频。

## 核心能力

* **文生视频** - 使用中文或英文提示词生成视频
* **同步音频** - 传入 WAV/MP3 音频，或由模型自动生成匹配的声音
* **分辨率** - `720P` 或 `1080P`
* **时长** - 2-15 秒的整数
* **宽高比** - `16:9`、`9:16`、`1:1`、`4:3` 或 `3:4`
* **输出格式** - 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-t2v",
    "input": {
      "prompt": "一艘纸船驶过霓虹灯映照的雨夜城市，电影感跟拍镜头。"
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "prompt_extend": true,
      "watermark": false,
      "seed": 42
    }
  }'
```

<Note>
  视频生成是异步任务。请保存返回的任务 ID，并通过 [Wan 任务查询接口](/zh/guides/model-api/alibaba/wan2-task-query)轮询结果。任务 ID 和成功后的结果链接有效期均为 24 小时。
</Note>

## 如何开启 NSFW 功能

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

## 参数说明

| 参数                         | 类型      | 必填 | 说明                             |
| -------------------------- | ------- | -- | ------------------------------ |
| `model`                    | string  | 是  | 必须为 `wan2.7-t2v`               |
| `input.prompt`             | string  | 是  | 中文或英文视频描述，最多 5,000 个字符         |
| `input.negative_prompt`    | string  | 否  | 不希望出现的内容，最多 500 个字符            |
| `input.audio_url`          | string  | 否  | 公开 WAV/MP3 URL；2-30 秒，最大 15 MB |
| `parameters.resolution`    | string  | 否  | `720P` 或 `1080P`，默认 `1080P`    |
| `parameters.ratio`         | string  | 否  | 输出宽高比，默认 `16:9`                |
| `parameters.duration`      | integer | 否  | 2-15 秒，默认 `5`                  |
| `parameters.prompt_extend` | boolean | 否  | 是否改写并扩展提示词，默认 `true`           |
| `parameters.watermark`     | boolean | 否  | 是否添加“AI 生成”水印，默认 `false`       |
| `parameters.seed`          | integer | 否  | `[0, 2147483647]` 范围内的随机种子     |

不传 `audio_url` 时，模型会自动生成匹配音频。音频长于视频时会被截断；音频短于视频时，剩余部分保持静音。

<CardGroup cols={2}>
  <Card title="API 参考" icon="code" href="/zh/api-reference/model-api/alibaba/wan2.7-t2v">查看完整请求参数。</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/text-to-video-api-reference)。

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