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

# 万相3.0-视频生成

万相 3.0（`wan3.0-video`）是 all-in-one 视频生成模型，统一支持参考、编辑、复刻、驱动等多种创作功能，四模态全能参考，最长支持30秒视频生成，可解析文件、网页及复杂图片。生产级角色一致性保持，音画真实，带来身临其境的视听冲击力。

Wan3.0-Video-Prime （`wan3.0-video-prime`）是万相 3.0 的高速版视频生成模型，能力对齐 Wan3.0-Video 标准版，支持四模态全能参考，最长可生成30秒视频，带来沉浸式视听体验的同时端到端速度显著提升。

### 模型参数

* 模型ID：`wan3.0-video`/`wan3.0-video-prime`
* 模型价格：你可以在模型详情页查看最新价格信息：[Wan3.0-Video](https://geekai.co/models/wan3.0-video) / [Wan3.0-Video-Prime](https://geekai.co/models/wan3.0-video-prime)
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations)
* API认证：[获取 API KEY](https://geekai.co/user/api_keys)

<Note>
  不支持视频 API 中的以下参数：

  * `size`
  * `quality`
  * `fps`

  附：[万相3.0/万相3.0-高速版官方 API 文档](https://bailian.console.aliyun.com/cn-beijing?tab=doc\&spm=5176.29619931.J__Z58Z6CX7MY__Ll8p1ZOR.1.74cd59fcEkLe98#/doc/?type=model\&url=3050323)
</Note>

`aspect_ratio` 参数支持以下取值：

* `1:1`
* `16:9`
* `9:16`
* `4:3`
* `3:4`
* `adaptive`（默认值，自适应宽高比）\`

`resolution` 参数支持以下取值：

* `480P`
* `720P`
* `1080P`（默认值）

`duration` 参数支持 `2-30` 秒，默认值为 `5` 秒。有参考视频传入时，输入视频+输出视频总时长不得超过 `30` 秒。

### 模型价格

万相3.0视频模型的价格按照生成视频的分辨率、时长来计算，以下是价格速算表：

| 模型                   | 分辨率   | 价格（单位：元/秒） |
| -------------------- | ----- | ---------- |
| `wan3.0-video`       | 480P  | 0.3        |
| `wan3.0-video`       | 720P  | 0.6        |
| `wan3.0-video`       | 1080P | 1.2        |
| `wan3.0-video-prime` | 480P  | 0.45       |
| `wan3.0-video-prime` | 720P  | 0.9        |
| `wan3.0-video-prime` | 1080P | 1.8        |

高速版生成速度更快，价格也更高。

如果传入了参考视频，则参考视频时长也参与计费，此时计费视频时长=输入视频时长+输出视频时长。

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price)调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用Pro渠道为例，折扣值是 `0.8`，那么生成 5 秒 720p 标准视频价格是 `0.6x5x0.8=2.4` 元，其他参数依次类推。

### 文生视频

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。",
    "resolution": "480P",
    "async": true
}'
```

<Note>
  视频生成比较耗时，建议统一通过异步方式请求(`async=true`)，然后通过轮询任务状态获取视频生成结果。
</Note>

### 查询结果

异步视频任务响应是一个 JSON 对象，包含视频生成任务ID：

```json theme={null}
{
    "model": "wan3.0-video",
    "task_id": "c542fe62-79b7-4fc0-9de2-0208a1663f54",
    "task_status": "pending"
}
```

通过响应中的任务 ID（`task_id`）可查询视频生成状态：

```bash theme={null}
curl --location --request GET 'https://geekai.co/api/v1/videos/c542fe62-79b7-4fc0-9de2-0208a1663f54' \
--header 'Authorization: Bearer $GEEKAI_API_KEY'
```

如果视频还在生成中，响应结果如下：

```json theme={null}
{
    "model": "wan3.0-video",
    "task_id": "c542fe62-79b7-4fc0-9de2-0208a1663f54",
    "task_status": "running"
}
```

当 `task_status` 值为 `succeed` 时表示视频生成，对应响应结果如下：

```json theme={null}
{
    "model": "wan3.0-video",
    "task_id": "c542fe62-79b7-4fc0-9de2-0208a1663f54",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "3a11bf1b-2fe5-4ff1-aee3-1317d6935905",
            "url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/62/20260827/e4b11e52/eece824d-22c1-4051-ac1c-fcf8de65e75a.mp4?Expires=1787901397&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=k5JpXcXdv3fAsNHr6f9C7wZ5Bkk%3D"
        }
    ],
    "created": 1787843570,
    "completed": 1787843804
}
```

视频生成结果位于 `video_result[0].url` 中，默认有效期 24 小时，请及时下载保存到本地。

下面图生视频等生成响应结构和获取生成视频结果是一样的，不再列举。

### 图生视频

**基于首帧**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由rap构成，没有其他对话或杂音。",
    "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
    "resolution": "480P",
    "async": true
}'
```

**基于首尾帧**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "一个年轻女孩从微笑逐渐变为大笑，镜头缓缓推进，背景光线从冷色调渐变为暖色调。",
    "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
    "image_tail": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg",
    "resolution": "480P",
    "async": true
}'
```

### 参考生视频

万相3.0视频模型支持基于参考图、参考视频、参考音频生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "视频1抱着图3，在图4的椅子上弹奏一支舒缓的乡村民谣，并说道：“今天的阳光真好。”图1手中拿着图2，路过视频1，把手中的图2放到视频1旁边的桌子上，并说道：“真好听，能不能再唱一遍”。",
    "images": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png" 
    ],
    "video": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
    ],
    "resolution": "480P",
    "async": true
}'
```

万相3.0最多支持10张参考图、5段参考视频（总时长不超过15秒）和5段参考音频（总时长不超过15秒）。

**参考文件**

除了参考图、视频和音频外，万相3.0还支持基于参考文件和网页链接生成视频，通过 `extra_body.file` 和 `extra_body.link` 传入对应的参考文件和网页链接即可，下面以参考文件生视频作为示例：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "一支高端智能眼镜产品广告，整体风格极简、未来感、时尚高级，光影克制，画面以黑色、银灰色、冰蓝色为主色调，局部点缀柔和白光与参数UI图形。开场在纯黑背景中，一副智能眼镜从黑暗中缓缓浮现，镜腿边缘掠过精致高光，镜框轮廓在冷冽边缘光下被勾勒出来，镜头超近距离掠过镜片、鼻托、转轴、镜腿与材质细节，展现金属与高性能复合材料的细腻质感，表面处理高级克制，线条轻薄流畅。随后产品在空中缓慢旋转，画面以极简动态图形同步展示核心参数信息。随后镜头快速收拢，所有零件精准回归组装成完整产品，切换到年轻模特佩戴展示，模特五官立体、气质自信，穿着简洁高级的都市时尚服装，在极简空间和城市光影环境中自然转头、抬手、行走、微笑，镜头从正面、侧面、斜后方展示眼镜佩戴状态，突出轻薄贴合、时尚轮廓与日常百搭属性。结尾在纯色背景中，产品悬浮定格，镜头缓慢推进到品牌logo和核心slogan，整体音乐极简电子氛围配合精准鼓点，节奏干净有力，画面质感高级、克制、纯粹，具有强烈品牌记忆点和国际化科技审美。",
    "extra_body": {
        "file": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260806/ebapmr/glass.pptx"
    },
    "resolution": "480P",
    "async": true
}'
```

### 视频编辑

万相3.0视频模型支持传入待编辑视频，结合 `prompt` 指令编辑视频内容：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "将整个画面转换为黏土风格",
    "video": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4",
    "resolution": "720P",
    "async": true
}'
```

**视频延长**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"wan3.0-video",
    "prompt": "将视频向后延长，面包师端上刷好的面包，将刷子放到一旁，镜头跟随面包师，去斜后方的烤炉进行烤制",
    "video": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4",
    "resolution": "720P",
    "async": true
}'
```