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

# Wan 3.0 — 参考生视频

> 使用阿里巴巴 Wan 3.0 或 Wan 3.0 Prime，由最多 10 张参考图片、5 段参考视频和 5 段音频生成 2–30 秒视频，或延长、编辑一段参考视频。

| | |
| - | - |
| **模型 ID** | `alibaba/wan-3-0-r2v`（Wan 3.0）、`alibaba/wan-3-0-prime-r2v`（Wan 3.0 Prime） |
| **系列** | `wan-3-0`、`wan-3-0-prime` |
| **任务** | `reference-to-video` |
| **模态** | 视频 |
| **上游** | Alibaba Wan 3.0 |

> [!NOTE]
>
> 两个模型 ID 接受相同的参数。Prime 端到端生成更快，每秒价格更高。
>
> 至少传入一路参考素材：图片、视频或音频。提示词按类型和位置引用它们，每种类型按数组顺序
> 分别编号：中文写作 `图1`、`视频1`、`音频1`……，英文写作 `image 1`、`video 1`、`audio 1`……
>
> 首帧/尾帧不能与参考素材组合使用。如需固定首帧或尾帧，请使用
> [图生视频](https://docs.vibetoken.cn/zh/alibaba-wan-3-0-api/image-to-video.md)。

## 计费

按秒计费，每秒费率由分辨率决定。计费秒数为输出秒数加上所有参考视频的秒数，向上取整到整秒。
提交时会测量参考视频的时长，并按该请求可能产生的最高费用从余额中预扣；最终按实际时长结算，
且不会超过预扣金额。生成失败不收费。当前每秒费率请见[定价页](https://vibetoken.cn/pricing)。

## 端点

```http theme={null}
POST https://vibetoken.cn/v1/videos/generations
```

异步接口 — 返回 `{id, status: "pending"}`；轮询
`GET /v1/videos/generations/{id}` 直到状态为 `success` 或 `failed`。

## 参数

**prompt** `string` *required*

描述目标片段以及如何使用各路参考素材的文本提示词。最多 20000 个字符。

**image\_urls** `string[]`

最多 10 张参考图片 URL（公网 HTTPS）：`图1`、`图2`……

**video\_urls** `string[]`

最多 5 段参考视频 URL（公网 HTTPS）：`视频1`、`视频2`……其秒数与输出一并计费。

**audio\_urls** `string[]`

最多 5 段参考音频 URL（公网 HTTPS）：`音频1`、`音频2`……

**resolution** `"480P" | "720P" | "1080P"` (default: "1080P")

输出分辨率。每档各有独立的每秒费率。

**ratio** `"adaptive" | "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9"` (default: "adaptive")

生成视频的宽高比。`adaptive` 让模型按参考素材自动匹配。

**duration** `integer` (default: 5)

生成片段的时长（秒），取值范围 `[2, 30]`。含参考视频时，参考视频秒数与输出秒数之和不能
超过 30 秒。

**audio** `boolean` (default: true)

生成音轨。设为 `false` 可得到无声片段。

**seed** `integer`

随机种子，取值范围 `[0, 2147483647]`。以相同请求复用同一种子，可更接近地复现结果。

**prompt\_extend** `boolean` (default: true)

生成前由模型扩写提示词。设为 `false` 则按原样使用提示词。

**watermark** `boolean` (default: false)

在视频上添加 AI 生成水印。

该模型不支持的选项不会转发给它。

## 延长或编辑视频

参考生视频也可以续写或编辑一段参考视频：把片段放入 `video_urls`，并在提示词中说明要做什么，
例如「延续视频1，汽车驶入隧道」或「把视频1中的天空换成雷暴」。

## 示例

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3-0-r2v",
    "prompt": "图1中的角色在图2的天台上随音频1起舞",
    "image_urls": [
      "https://example.com/character.png",
      "https://example.com/rooftop.png"
    ],
    "audio_urls": ["https://example.com/track.mp3"],
    "resolution": "720P",
    "duration": 10
  }'
```

使用 Prime 档位时，将 `"model"` 改为 `"alibaba/wan-3-0-prime-r2v"`，请求体其余部分不变。

```json theme={null}
{ "id": "task_abc123…", "status": "pending", "model": "alibaba/wan-3-0-r2v" }
```

轮询直到进入终态：

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations/task_abc123… \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY"
```

```json theme={null}
{
  "id": "task_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.