> ## 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 音画同步升级，主体一致性增强，支持多镜头叙事。

在可灵视频 O1 和可灵视频 2.6 的基础之上，可灵 3.0 系列模型基于深度融合的统一模型训练框架，实现了更原生的多模态输入和输出，将音画同步能力和主体一致性控制能力融合，并且突破了时长限制。

在支持更长视频生成（15s）的同时，可灵 3.0 系列模型支持原生直出音画，并实现了高度灵活的分镜控制能力与更精准的语义响应精度，为 AI 影像内容注入生命力，整体画面真实感显著提升，人物演绎更具表演张力。

![可灵视频 3.0 模型能力对比概览](https://static.geekai.co/storage/2026/02/27/image-20260227142959902.png)

### 模型参数

* 模型ID：`kling-video-v3`
* 模型价格：你可以在[模型广场](https://geekai.co/models?platform=kling\&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`
  * `fps`

  附：[可灵视频 3.0 官方 API 文档](https://docs.qingque.cn/d/home/eZQCedMeoI1MTquS1SFRihz4S?identityId=1oEFzU43FYK#section=h.0zdc4fiohq6h)
</Note>

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

* `1:1`
* `16:9`
* `9:16`

支持通过 `quality` 参数替代官方的 `mode` 参数来控制生成视频的分辨率，`quality` 的取值范围是 `std`（对应 `720p`）、 `pro`（对应 `1080p`）和 `4k`（v3开始支持），默认值是 `std`，不同质量的视频生成时间和成本不同。

支持通过 `with_audio` 参数替代官方的 `sound` 参数来控制是否生成带有音频的视频，`with_audio` 的取值范围是 `true` 和 `false`，默认值是 `false`，生成带有音频的视频会增加生成时间和成本。

支持通过 `watermark` 参数替代官方的 `watermark_info` 参数来控制生成视频是否带有水印，`watermark` 的取值范围是 `true` 和 `false`，默认值是 `false`。

可灵视频 3.0 的 `duration` 参数支持生成 3-15s 的视频，默认值是 5s，生成更长时长的视频会增加生成时间和成本。

支持通过 `extra_body` 传递额外参数来设置视频分镜、参考主体和音色等信息：

* `multi_shot`： 控制是否开启分镜，取值范围是 `true` 和 `false`，默认值是 `false`，开启多镜头模式后，可以通过 `shot_type` 参数来指定分镜类型。
* `shot_type`： 指定分镜类型，取值范围是 `customize` 和 `intelligence`，分别代表自定义分镜和智能分镜， 当 `multi_shot` 为 `true` 时本参数必填。
* `multi_prompt`： 描述每个分镜的信息，如提示词、时长等，当 `multi_shot` 为 `true` 且 `shot_type` 为 `customize` 时，本参数必填。
* `element_list`： 参考主体列表，基于主体库中主体的 ID 配置，最多支持3个。
* `voice_list`： 生成视频时所引用的音色的列表，基于定制音色ID进行设置，最多支持2个，`element_list` 与 `voice_list` 互斥，不能共存。
* `camera_control`: 控制相机运动的条款（如不指定，模型将根据输入的文本/图片智能匹配）。
* `static_mask`: 静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）。
* `dynamic_masks`: 动态笔刷配置列表。

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

![可灵视频 3.0 分镜参数说明](https://static.geekai.co/storage/2026/02/27/image-20260227150217721.png)

### 模型价格

可灵视频 3.0 的价格按照生成视频的质量、时长和是否带有音频来计算，以下是价格表：

| 模型      | 质量       | 声音 | 价格（单位：元/秒） |
| ------- | -------- | -- | ---------- |
| 可灵视频3.0 | 标准（std）  | 无声 | 0.6        |
| 可灵视频3.0 | 标准（std）  | 有声 | 0.9        |
| 可灵视频3.0 | 高品质（pro） | 无声 | 0.8        |
| 可灵视频3.0 | 高品质（pro） | 有声 | 1.2        |
| 可灵视频3.0 | 超高清（4k）  | 无声 | 3.0        |
| 可灵视频3.0 | 超高清（4k）  | 有声 | 3.0        |

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price)调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用速度优先渠道为例，折扣值是 `0.8`，那么生成 5 秒无声标准视频价格是 `0.6 x 5 x 0.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":"kling-video-v3",
    "prompt":"广角跟踪镜头：一辆影青色的双门轿跑在沙漠公路上行驶，热浪扭曲清晰可见，头顶烈日高悬"
}'
```

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

```json theme={null}
{
    "model": "kling-video-v3",
    "task_id": "2047e9ae-e369-42b9-8b1b-8a030dedd86c",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "6fe5f026-d171-4d5d-9113-e95f65dc5aa7",
            "url": "https://static.geekai.co/video/2026/02/27/e31df3d32e0242211dc20ff5b7f66289.mp4"
        }
    ]
}
```

### 图生视频

**首帧**

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

**首尾帧**

通过 `image` + `image_tail` 传入首尾两张图即可实现基于首尾帧生成视频：

```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": "kling-video-v3",
    "prompt": "图中女孩对着镜头说\"茄子\"，360度环绕运镜",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
    "image_tail": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg",
    "async": true
}'
```

图片要求：

* 支持 JPG、PNG、WEBP 格式，单张图片大小不超过 10MB；
* 支持 URL 和 Base64 两种方式传入图片，URL 方式需要保证图片可以被公网访问；
* 图片宽高尺寸不小于 300px，图片宽高比介于 1:2.5 \~ 2.5:1 之间；
* image 参数与 image\_tail 参数至少二选一，二者不能同时为空。

### 视频分镜

可灵视频 3.0 支持通过 `extra_body` 参数来控制分镜能力，以下是一个多镜头图生视频示例：

```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":"kling-video-v3",
    "prompt":"她转身一笑，然后缓缓走出画面",
    "image":"https://static.geekai.co/storage/2025/11/14/woman_skyline_original_720p.jpeg",
    "duration": 8,
    "extra_body": {
        "multi_shot": true,
        "shot_type": "customize",
        "multi_prompt": [
            {
                "index": 1,
                "prompt": "第一镜头：她转身一笑",
                "duration": "3"
            },
            {
                "index": 2,
                "prompt": "第二镜头：她缓缓走出画面",
                "duration": "5"
            }
        ]
    },
    "async": true
}'
```

### 异步任务

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

[视频 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":"kling-video-v3",
    "prompt":"她转身一笑，然后缓缓走出画面",
    "image":"https://static.geekai.co/storage/2025/11/14/woman_skyline_original_720p.jpeg",
    "duration": 15,
    "quality": "pro",
    "with_audio": true,
    "async": true
}'
```

响应中会包含任务ID：

```json theme={null}
{
    "model": "kling-video-v3",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "pending"
}
```

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

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

```bash theme={null}
curl --location --request GET 'https://geekai.co/api/v1/videos/77e3772b-4e92-4fce-a24c-63907585689d' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' 
```

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

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

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

```json theme={null}
{
    "model": "kling-video-v3",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "running"
}
```

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

```json theme={null}
{
    "model": "kling-video-v3",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2025/10/14/6c6b8c475899a1c82bcd59a84e78ab46.mp4"
        }
    ]
}
```