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

# 可灵视频 v2.5 Turbo

可灵2.5 Turbo 模型，效果进一步提升。文本理解与响应显著提升，能更深入理解具有因果关系的复杂指令，实现对创意表达的精细化控制。动态效果进一步增强，能生成动态幅度更大的动作和运镜，在提升运动呈现幅度和强度的同时，更流畅，更稳定。风格保持、美学效果等进一步提升，在色彩影调、光影分布、笔触质感和整体氛围以及风格统一性上显著提升

### 模型参数

* 模型ID：`kling-video-v2-5-turbo`
* 模型价格：你可以在[模型广场](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 中的以下参数：

  * `with_audio`
  * `size`
  * `fps`

  附：[可灵视频 v2.5 Turbo 官方 API 文档](https://app.klingai.com/cn/dev/document-api/apiReference/model/textToVideo)

  标准模式std下不支持`image_tail`参数，只有文生视频才支持`aspect_ratio`参数。
  支持传入图片 Base64 编码，在对应的image、image\_tail参数中传入即可。
</Note>

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

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

可灵视频 v2.5 Turbo 的 `duration` 参数支持生成 5s和10s 的视频，默认值是 5s

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

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

支持通过 `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`: 动态笔刷配置列表。

### 文生视频

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

```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-v2-5-turbo",
    "prompt": "一只可爱的小兔子，戴着眼镜，坐在桌边，看报纸，桌上放着一杯卡布奇诺",
    "aspect_ratio": "16:9",
    "quality": "std"
}'
```

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

```json theme={null}
{
    "model": "kling-video-v2-5-turbo",
    "task_id": "33b6015a-6817-45de-9e0d-2452eb563fbb",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "855872092758622288",
            "url": "https://static.geekai.co/video/2026/02/26/514a1da5fcce3da089bc57ebbcfafca8.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": "kling-video-v2-5-turbo",
    "prompt": "生成一个小猫玩球的可爱视频",
    "image": "https://static.geekai.co/image/2026/02/26/f64163e4cb9ad3df328174731c38e622.png",
    "quality": "std",
    "duration": 5
}'
```

**首尾帧**

```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-v2-5-turbo",
    "prompt": "镜头拉远，女生微笑",
    "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png",
    "image_tail": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png",
    "quality": "pro"
}'
```

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