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

# Wan 视频

> Wan 视频模型总览。Wan 文生视频使用 /v1/video/generations；图生、首尾帧和主体参考等阿里格式工作流使用 /alibailian/api/v1/* 兼容路径

> 更新日期：2026-06-07

# Wan 视频

Wan 系列当前按能力使用不同对客协议：

* 文生视频（`wan2.5-t2v-preview`、`wan2.2-t2v-plus`）：使用 `POST /v1/video/generations`，并通过 `GET /v1/video/generations/{task_id}` 查询。
* 图生视频、首尾帧生视频、主体参考生视频：使用阿里百炼兼容路径 `POST /alibailian/api/v1/services/aigc/video-generation/video-synthesis`，并通过 `GET /alibailian/api/v1/tasks/{task_id}` 查询。

<Warning>
  不要把 `wan2.2-t2v-plus` 提交到 `/alibailian/api/v1/services/aigc/video-generation/video-synthesis`。生产环境会返回 `invalid_request`，并提示改用 `/v1/video/generations`。
</Warning>

阿里格式工作流的完整请求体和任务查询格式请查看 [阿里百炼视频接口](/video/alibailian)。本页收口当前首批对外开放的 `Wan` 模型、能力、计费口径和推荐协议。

## 首批模型

| 模型                   | 对客能力    | 官方计费口径 | 当前状态 |
| -------------------- | ------- | ------ | ---- |
| `wan2.5-t2v-preview` | 文生视频    | 按秒     | 已验证  |
| `wan2.5-i2v-preview` | 图生视频    | 按秒     | 已验证  |
| `wan2.2-t2v-plus`    | 文生视频    | 按秒     | 已验证  |
| `wan2.2-i2v-plus`    | 图生视频    | 按秒     | 已验证  |
| `wan2.2-i2v-flash`   | 图生视频    | 按秒     | 已验证  |
| `wan2.2-kf2v-flash`  | 首尾帧生视频  | 按秒     | Beta |
| `wan2.2-s2v`         | 主体参考生视频 | 按秒     | Beta |

<Note>
  `wan2.2-kf2v-flash` 与 `wan2.2-s2v` 已经完成代码和计费能力桶对齐，但当前 live artifact 还在继续补齐，所以先保留 Beta 标记。
</Note>

## 能力与官方价格

| 模型                   | 能力桶     | 分辨率                   | 官方单价                        |
| -------------------- | ------- | --------------------- | --------------------------- |
| `wan2.5-t2v-preview` | 文生视频    | `480P / 720P / 1080P` | `¥0.30 / ¥0.60 / ¥1.00 / 秒` |
| `wan2.2-t2v-plus`    | 文生视频    | `480P / 1080P`        | `¥0.14 / ¥0.70 / 秒`         |
| `wan2.2-i2v-plus`    | 图生视频    | `480P / 1080P`        | `¥0.14 / ¥0.70 / 秒`         |
| `wan2.2-i2v-flash`   | 图生视频    | `480P / 720P / 1080P` | `¥0.10 / ¥0.20 / ¥0.48 / 秒` |
| `wan2.2-kf2v-flash`  | 首尾帧生视频  | `480P / 720P / 1080P` | `¥0.10 / ¥0.20 / ¥0.48 / 秒` |
| `wan2.2-s2v`         | 主体参考生视频 | `480P / 720P`         | `¥0.50 / ¥0.90 / 秒`         |

## 协议约定

### 1. 文生视频

* 推荐提交路径：`POST /v1/video/generations`
* 推荐查询路径：`GET /v1/video/generations/{task_id}`
* 重点字段：`model`、`prompt`、`seconds`、`size`
* 典型模型：`wan2.5-t2v-preview`、`wan2.2-t2v-plus`

### 2. 图生视频

* 重点字段：`input.img_url`
* 典型模型：`wan2.5-i2v-preview`、`wan2.2-i2v-plus`、`wan2.2-i2v-flash`

### 3. 首尾帧生视频

* 重点字段：`input.first_frame_url`、`input.last_frame_url`
* 典型模型：`wan2.2-kf2v-flash`

### 4. 主体参考生视频

* 重点字段：`input.image_url`
* 典型模型：`wan2.2-s2v`

## 请求示例

### 文生视频：Wan 2.2 T2V Plus

```bash cURL theme={null}
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "wan2.2-t2v-plus",
    "prompt": "一段平静的电影感山间云海镜头",
    "seconds": "5",
    "size": "480P"
  }'
```

### 图生视频

```bash cURL theme={null}
curl -X POST https://api.crazyrouter.com/alibailian/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "wan2.5-i2v-preview",
    "input": {
      "prompt": "让画面中的人物转头看向镜头",
      "img_url": "https://example.com/first-frame.png"
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "prompt_extend": true,
      "audio": true
    }
  }'
```

### 首尾帧生视频

```json theme={null}
{
  "model": "wan2.2-kf2v-flash",
  "input": {
    "prompt": "镜头从白天平滑过渡到夜晚",
    "first_frame_url": "https://example.com/frame-start.png",
    "last_frame_url": "https://example.com/frame-end.png"
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5
  }
}
```

### 主体参考生视频

```json theme={null}
{
  "model": "wan2.2-s2v",
  "input": {
    "prompt": "让参考人物自然说话并有轻微头部动作",
    "image_url": "https://example.com/portrait.png",
    "audio_url": "https://example.com/voice.mp3"
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5
  }
}
```

## 任务取回

Wan 当前仍是异步任务模型。客户创建任务后，按提交协议查询：

文生视频：

```http theme={null}
GET /v1/video/generations/{task_id}
```

阿里兼容图生、首尾帧和主体参考工作流：

```http theme={null}
GET /alibailian/api/v1/tasks/{task_id}
```

当查询返回 `status = SUCCESS` 时，从 `result_url` 或 `artifact_url` 获取最终视频结果。

## 边界说明

* Wan 文生视频的当前推荐对客协议是 `/v1/video/generations`，不是阿里百炼兼容提交路径。
* 阿里百炼兼容路径主要用于图生视频、首尾帧生视频、主体参考生视频等阿里格式迁移场景。
* Crazyrouter 内部可以把官方、ApiPass、Kie 或其他第三方作为 provider，但这些 provider 不单独定义客户协议。
* 当前 Beta 行可以先对客展示；上线后应结合生产任务日志继续补 live evidence，成功闭环后再去掉 Beta 标记。
