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

# Vidu Q2

Vidu Q2是生数科技发布的新一代多模态大模型，在语义理解、情绪表达、运动幅度、专业运镜等方面都有了全面升级，在影视动漫、广告电商、短剧、泛娱乐、文旅等行业中有更大、更深入的应用空间。
指令遵循更强，表情理解更细腻，运动幅度更灵活，运镜更连贯。

### 模型参数

* 模型ID：`viduq2`/`viduq2-turbo`/`viduq2-pro`
* 模型价格：你可以在[模型广场](https://geekai.co/models?platform=vidu\&type=video)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations)
* API认证：[获取 API KEY](https://docs.geekai.co/cn/docs/quick_start)

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

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

  附：[ViduQ2 官方 API 文档](https://platform.vidu.cn/docs/text-to-video)
</Note>

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

* `1:1`
* `16:9`
* `9:16`
* `4:3`
* `3:4`

`resolution` 分辨率参数，可选：540p、720p、1080p

`duration` 默认为 5s,可选值：1-10s

支持通过 `extra_body` 传递额外可选参数来设置：

* `style`: 风格，可选值: general（通用风格）、anime（动漫风格，仅在动漫风格表现突出）
* `movement_amplitude`: 运动幅度默认 auto, 可选值: auto、small、medium、large
* `bgm`: 是否为生成的视频添加背景音乐。默认: false, 可选值 true 、false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM
* `voice_id`: 音色id,用来决定视频中的声音音色
* `wm_url`: 水印内容,此处为图片URL
* `wm_position`: 水印位置，表示水印出现在图片的位置
* `off_peak`: 错峰模式，默认: false,可选值: true: 错峰生成视频; false: 即时生成视频
* `payload`: 透传参数,不做任何处理，仅数据传输
* `meta_data`: 元数据标识,json格式字符串,透传字段

以上字段参数类型和官方参数完全一致

### 模型价格

vidu q2系列 的价格按照模型，能力，生成视频的分辨率、时长来计算，以下是价格速算表：

| 能力     | 模型           | 分辨率   | 价格（元/秒） |
| ------ | ------------ | ----- | ------- |
| 文生视频   | viduq2       | 540p  | 0.3125  |
|        | viduq2       | 720p  | 0.46875 |
|        | viduq2       | 1080p | 0.625   |
| 参考生视频  | viduq2       | 540p  | 0.46875 |
|        | viduq2       | 720p  | 0.78125 |
|        | viduq2       | 1080p | 2.34375 |
|        | viduq2-pro   | 540p  | 0.625   |
|        | viduq2-pro   | 720p  | 0.9375  |
|        | viduq2-pro   | 1080p | 2.65625 |
| 图生视频   | viduq2-turbo | 540p  | 0.1875  |
|        | viduq2-turbo | 720p  | 0.25    |
|        | viduq2-turbo | 1080p | 1.09375 |
|        | viduq2-pro   | 540p  | 0.25    |
|        | viduq2-pro   | 720p  | 0.46875 |
|        | viduq2-pro   | 1080p | 1.71875 |
| 首尾帧生视频 | viduq2-turbo | 540p  | 0.1875  |
|        | viduq2-turbo | 720p  | 0.25    |
|        | viduq2-turbo | 1080p | 1.09375 |
|        | viduq2-pro   | 540p  | 0.25    |
|        | viduq2-pro   | 720p  | 0.46875 |
|        | viduq2-pro   | 1080p | 1.71875 |

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

### 文生视频

通过文字描述来生成对应视频：

```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": "viduq2",
    "prompt": "以超写实的时尚摄影风格呈现，采用浅蓝与淡琥珀色调，身着宇航服的航天员漫步雾中。背景由迷人的白金光线构成，营造出极简静物与令人震撼的全景画面。",
    "duration": 5,
    "aspect_ratio": "16:9"
}'
```

响应是一个 JSON 对象，包含生成视频的 URL：

```json theme={null}
{
    "model": "viduq2",
    "task_id": "72bc4fd2-3c43-4571-b72f-db3aad3096fb",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "038a74c4-762a-47c1-a8ba-e0c5d950ab9c",
            "url": "https://static.geekai.co/video/2026/03/05/152c1175b4379ccab9c48b12b8f5a4a4.mp4"
        }
    ]
}
```

下面的图生视频等响应结果同上，不在列举。

### 图生视频

```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": "viduq2-turbo",
    "prompt": "宇航员挥手致意，镜头缓缓上移",
    "images": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
    "duration": 5,
    "with_audio": true
}'
```

<Note>viduq2-turbo和viduq2-pro支持图生视频</Note>

### 首尾帧

```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": "viduq2-turbo",
    "prompt": "镜头拉近那只鸟，它随即向右飞去。鸟儿飞行姿态流畅自然，在天空中翱翔，身后随之环绕着红色光效。",
    "image": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg",
    "image_tail": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg",
    "duration": 5
}'
```

<Note>viduq2-turbo和viduq2-pro支持首尾帧生视频</Note>

### 参考生视频

```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": "viduq2-pro",
    "prompt": "圣诞老人和熊在湖边拥抱。",
    "image": [
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
    ],
    "duration": 4,
    "aspect_ratio": "4:3"
}'
```

<Note>viduq2和viduq2-pro支持参考生视频， `duration`: viduq2-pro：默认5秒，可选：0-10（0秒为自动判断时长）</Note>

### 异步任务

由于视频生成通常比较耗时，建议通过极客智坊提供的异步任务模式生成视频。

[视频 API](https://docs.geekai.co/cn/api/video/generations) 中的 `async` 参数用于控制是否异步生成视频，默认为 `false`，表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 `true`，则会异步生成视频并返回任务ID，你可以使用该任务ID轮询视频生成状态。

**创建视频生成任务**

```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": "viduq2",
    "prompt": "以超写实的时尚摄影风格呈现，采用浅蓝与淡琥珀色调，身着宇航服的航天员漫步雾中。背景由迷人的白金光线构成，营造出极简静物与令人震撼的全景画面。",
    "duration": 5,
    "aspect_ratio": "16:9",
    "async": true,
    "extra_body": {
        "bgm": true
    }
}'
```

响应中会包含任务ID：

```json theme={null}
{
    "model": "viduq2",
    "task_id": "371a39ff-d1a6-4990-8c7b-3dcc7e437861",
    "task_status": "pending"
}
```

**查询视频生成结果**

你可以使用返回的任务 ID 来查询生成状态和获取视频结果：

```bash theme={null}
curl --location --request GET 'https://geekai.co/api/v1/videos/{task_id}' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' 
```

你可以根据视频生成任务状态 `task_status` 值判断视频是否已经生成完成，这个状态值包括四种情况：

* `pending`：任务已创建，等待处理
* `running`：任务正在处理
* `succeed`：任务成功完成，可以获取结果
* `failed`：任务失败，可能是由于内容违规或其他错误

如果任务还在运行中，返回结果如下：

```json theme={null}
{
    "model": "viduq2",
    "task_id": "371a39ff-d1a6-4990-8c7b-3dcc7e437861",
    "task_status": "running"
}
```

轮询视频生成结果接口直到任务状态值为 `succeed`，你就可以获取到生成的视频 URL：

```json theme={null}
{
  "model": "viduq2",
  "task_id": "371a39ff-d1a6-4990-8c7b-3dcc7e437861",
  "task_status": "succeed",
  "video_result": [
    {
      "id": "30751061-18f8-41d7-8aa1-fea6415a5a01",
      "url": "https://static.geekai.co/video/2026/03/05/45abad7a92d050bfce23fb5768eee698.mp4"
    }
  ]
}
```