> ## 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 Q4 Preview

Vidu Q4 Preview 围绕人物演绎、镜头语言和复杂视效等能力进一步升级，最多支持15张参考图、3段参考音频，并支持2K、4K输出。

### 模型参数

* 模型ID：`viduq4-preview`
* 模型价格：你可以在模型详情页查看最新价格信息：[Vidu Q4 Preview](https://geekai.co/models/viduq4-preview)
* 调用入口：`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 中的以下参数：

  * `negative_prompt`
  * `image_tail`
  * `video`
  * `action`
  * `size`
  * `quality`
  * `fps`
  * `draft`
  * `draft_task_id`
  * `output_format`

  附：[Vidu Q4 Preview 官方 API 文档](https://platform.vidu.cn/docs/api-reference/video-models/vidu-q4-preview)
</Note>

Vidu Q4 Preview 系列模型支持的 `aspect_ratio` 宽高比如下：

* `16:9`：横屏
* `9:16`：竖屏
* `3:4`：竖屏
* `4:3`：横屏
* `1:1`：方形

支持 `resolution` 分辨率为 `540p`、`720p`、`1080p`、`2k`、`4k`，默认值为 `720p`。

支持 `duration` 视频时长为 `3`-`16` 秒，默认值为 `5` 秒。

支持通过 `enhance_prompt` 替代官方的 `is_rec` 实现对提示词的扩写和增强。

支持通过 `extra_body` 传递官方额外可选参数，同 Vidu Q3 的示例。

### 模型价格

Viduq4-preview 系列模型的价格按照生成视频的分辨率和时长来计算，以下是价格速算表：

| 模型 | 分辨率 | 价格（单位：元/秒） |
| - | - | - |
| Vidu Q4 Preview | 540p | 0.3 |
| Vidu Q4 Preview | 720p | 0.6 |
| Vidu Q4 Preview | 1080p | 0.75 |
| Vidu Q4 Preview | 2k | 1.2 |
| Vidu Q4 Preview | 4k | 2.4 |

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price)调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用Pro渠道为例，折扣值是 `0.8`，那么生成一段分辨率为 `720P`、时长为 `5` 秒的视频价格是 `0.6 x 5 x 0.8 = 2.4` 元，如果生成同样时长但分辨率为 `2K` 的视频价格是 `1.2 x 5 x 0.8 = 4.8` 元。渠道折扣也适用于其他计费项。

### 图生视频

Vidu Q4 Preview 仅支持图（首帧）生视频、参考（图+音频）生视频，文生视频请切换到 Vidu Q3 系列模型。

**首帧**

通过 `image` 传入单图即可实现基于首帧生成视频：

```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": "viduq4-preview",
    "prompt": "无人机以极快速度穿越复杂障碍或自然奇观，带来沉浸式飞行体验",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_i2v.png",
    "async": true
}'
```

### 参考生视频

Vidu Q4 Preview 支持基于参考图+音频生成视频，最多支持15张参考图+3段参考音频。

**参考图**

通过 `images` 传入一张或多张图即可实现基于多张参考图生成视频：

```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": "viduq4-preview",
    "prompt": "@图1戴着眼镜穿着蓝色T恤的男生和@图2的柯基小狗，坐在@图3的草坪上，3D卡通风格",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
    ],
    "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": "viduq4-preview",
    "prompt": "全程使用音频1作为背景音乐生成第一人称视角果茶宣传广告，极客农场牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
    ],
    "audio": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
    ],
    "with_audio":true,
    "aspect_ratio": "16:9",
    "duration": 11,
    "async": true,
    "watermark": false
}'
```

### 异步任务

视频任务耗时较长，建议都通过异步任务创建视频，避免同步等待超时。

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

具体操作请参考[Sora-2示例](https://docs.geekai.co/cn/docs/video/openai/sora-2#异步任务)，流程完全一样。


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