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

Vidu Q3是vidu新一代模型，支持原生音频+视频一体生成，支持自然的多角色对话，音频与画面同步输出，对话、旁白、音效、音乐四类音轨同步生成，单次生成即可获得完整 16 秒视频，表达更充分、叙事更连贯——减少拼接、避免节奏断裂，让故事自然推进，
从运镜到节奏，你可以精确指挥每一个叙事节点；逐帧级控制帮助你落准关键时刻的时机、重音与情绪节拍。支持英语、日语、中文的视频输出，面向漫剧、电影、短剧等专业叙事场景设计。

### 模型参数

* 模型ID：`viduq3-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`

  附：[ViduQ3 官方 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-16s

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

### 模型价格

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

| 模型         | 分辨率   | 价格（单位：元/秒） |
| ---------- | ----- | ---------- |
| viduq3-pro | 540p  | 0.4375     |
| viduq3-pro | 720p  | 0.9375     |
| viduq3-pro | 1080p | 1          |

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

### 文生视频

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

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

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

```json theme={null}
{
    "model": "viduq3-pro",
    "task_id": "d165a50c-9b6a-47cf-be34-24565f95b26f",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "052b2273-216d-432f-bc3b-4e06b196facb",
            "url": "https://static.geekai.co/video/2026/03/05/fde3ffee3c6acbab01dba9e6563d1f93.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": "viduq3-pro",
    "prompt": "宇航员挥手致意，镜头缓缓上移",
    "images": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
    "duration": 5,
    "with_audio": 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": "viduq3-pro",
    "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
}'
```

### 异步任务

如果想要异步创建视频获取生成结果请参考[ViduQ2示例](https://docs.geekai.co/cn/docs/video/vidu/viduq2),流程完全一样。