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

# Kling 4.0

Kling 4.0 是快手可灵新一代视频生成模型，主打真实、可控、专业。重点攻克大幅度动态与复杂运镜，高速运动、跟拍、环绕等镜头下画面稳定连贯；单次原生生成 3–30 秒，支持长镜头与连续叙事。关键帧模式支持首帧、首尾帧及时间轴任意位置的中间帧，最多 10 张；全能参考单任务可组合最多 15 项素材（图片、视频、主体、音色），精准复用外观、动作、运镜与节奏，并支持对已有视频做表情、动作、背景等局部编辑。音画同出，双声道立体声，多语种口型同步；提示词最长 8,000 tokens。输出 720p / 1080p，支持 21:9 超宽画幅，适用于广告营销、影视短片、短剧与电商内容创作。

### 模型参数

* 模型ID：`kling-video-4.0`
* 模型价格：你可以在模型详情页查看最新价格信息：[Kling 4.0](https://geekai.co/models/kling-video-4.0)
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations.md)
* API认证：[获取 API KEY](https://geekai.co/user/api_keys)

> [!NOTE]
>
> 不支持视频 API 中的以下参数：
>
> * `negative_prompt`
> * `size`
> * `quality`
> * `fps`

Kling 4.0 模型支持的 `aspect_ratio` 宽高比如下：

* `16:9`：横屏
* `9:16`：竖屏
* `1:1`：方形
* `21:9`：超宽屏
* `adaptive`：自适应（根据提示词意图自动选择合适的宽高比）

> [!NOTE]
>
> 图生视频不支持传入 `aspect_ratio` 参数。

Kling 4.0 模型支持的 `duration` 视频时长为 `3`-`30` 秒。

极客智坊视频接口通过 `action` 参数来区分不同的任务类型（和官方的文生视频/图生视频/参考生视频接口对齐），该参数不能为空，必须根据任务类型选择正确的值，否则调用会报错。以下是 Kling 4.0 支持的任务类型：

* `text-to-video`：文生视频
* `image-to-video`：图生视频，支持首帧、首尾帧、以及首尾帧+中间帧
* `omni-video`：参考生视频，支持图片、视频、音频和主体，最多支持10张参考图+5个参考视频+3个参考音色+7个主体，且参考素材总数不能超过15

Kling 4.0 支持的 `resolution` 分辨率为 `720p`、`1080p`，默认值为 `720p`。

### 模型价格

Kling 4.0 模型的价格按照生成视频的分辨率和时长来计算，以下是价格速算表：

| 模型 | 分辨率 | 带参考视频 | 价格（单位：元/秒） |
| - | - | - | - |
| Kling 4.0 | 720p | 否 | 1.0 |
| Kling 4.0 | 1080p | 否 | 1.5 |
| Kling 4.0 | 720p | 是 | 0.6 |
| Kling 4.0 | 1080p | 是 | 0.9 |

当传入参考视频时，参考视频时长参与计费，具体计算方式如下：

* 输入时长≤输出时长：总时长 = 输出时长x2
* 输入时长>输出时长：总时长 = 输入时长+输出时长

以 Kling 4.0 生成 `720p` 视频时长 `5` 秒为例，若不包含参考视频，则计费秒数为 `5` 秒，对应计费金额为 `5 x 1.0 = 5` 元；若包含参考视频，参考视频时长为 `3` 秒，则总时长为 `5 x 2 = 10` 秒，对应计费金额为 `10 x 0.6 = 6` 元。

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price.md)调用时，不同参数对应价格按照价格表x对应的折扣值计算即可。

### 文生视频

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

```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 '{
    "action": "text-to-video",
    "model": "kling-video-4.0",
    "prompt": "小猫对着镜头打哈欠",
    "async": true
}'
```

响应是一个包含生成视频的任务 ID 的 JSON 对象，你可以通过 [视频查询接口](https://docs.geekai.co/cn/api/video/result.md) 轮询视频生成状态，当状态值为 `succeed` 时，表示视频生成成功，响应中会返回视频 URL：

```json theme={null}
{
    "task_id": "5b36a98e-e202-43f8-8a28-cecdc83020b8",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2026/01/15/c07071e78203f406b0a607a2120adc11.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 '{
    "action": "image-to-video",
    "model": "kling-video-4.0",
    "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 '{
    "action": "image-to-video",
    "model": "kling-video-4.0",
    "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
}'
```

如果想要像官方一样传入中间帧，通过 `images` 以数组形式传入即可，所有图片支持 URL 和 base64 编码。且图片要求如下：

* 图片格式支持.jpg/.jpeg/.png
* 图片文件大小不能超过30MB
* 图片宽高尺寸不小于300px，图片宽高比要在2:5 \~ 5:2之间
* 图片数量不得超过10

### 参考生视频

Kling 4.0 支持基于参考图+视频+音频生成视频，且最大支持 15 个参考素材，包含至多 10 张参考图 + 5 个参考视频 + 3 个参考音色 + 7 个参考主体。

**参考图**

通过 `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 '{
    "action": "omni-video",
    "model": "kling-video-4.0",
    "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
}'
```

传入 `images` 参数时，同时也支持通过 `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 '{
    "action": "omni-video",
    "model": "kling-video-4.0",
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片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"
    ],
    "videos": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
    ],
    "audio": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
    ],
    "action": "reference",
    "aspect_ratio": "16:9",
    "duration": 15,
    "async": true
}'
```

> [!NOTE]
>
> 为了和官方API 的 `base_video` 和 `feature_video` 对标区分待编辑视频和参考视频，极客智坊通过 `videos` 传入参考视频，对应类型为 `feature_video`，通过 `video` 传入单个待编辑视频，对应类型为 `base_video`。

另外为了简化 API 调用，这里和 Seedance/MiniMax 一样，通过 `audio` 传入一个或多个自定义音频 URL，极客智坊会自动调用音色管理 API 将其转化为自定义音色 ID 注入，然后通过@音频1、@音频2等方式在提示词中引用即可。

自定义参考主体也可以用类似方式传入，参考 [Kling 3.0 文档](https://docs.geekai.co/cn/docs/video/kling/kling-video-v3.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%B8%BB%E4%BD%93)即可。

你也可以通过调用音色管理 API 和主体管理 API 来获取自定义音色 ID 和主体 ID，然后在提示词中引用，此时需要通过 `extra_body.voice_list` 和 `extra_body.element_list` 来传入自定义音色和主体信息：

```json theme={null}
{
    ...
    "extra_body": {
        "voice_list": [
            {
                "id": "音频1",
                "voice_id": "自定义音色ID"
            }
            ...
        ],
        "element_list": [
            {
                "id": "主体1",
                "element_id": "自定义主体ID"
            }
            ...
        ]
    }
}
```

### 视频编辑

你可以通过 `video` 参数传入待编辑视频来引导视频生成，生成的视频会在参考视频的基础上进行编辑：

```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 '{
    "action": "omni-video",
    "model": "kling-video-4.0",
    "prompt": "将视频中的小猫换成小狗，其他不变",
    "video": "https://static.geekai.co/video/2026/04/02/f2ffbccd56d65ab172aef3706e003aa7.mp4",
    "async": true
}'
```


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