创建视频任务 - 可灵 Kling

POST

/v1/videos/kling

可灵 Kling 系列创建视频任务。

⚠️ 实际请求路径:/v1/videos 或 /v1/video/generations(与 happyhorse、Vidu 共用)。此处使用 /v1/videos/kling 仅为在 Apifox 中区分接口,导入后可在 Apifox 中改回 /v1/videos。

任务类型触发条件:

images 为空 → 文生视频

images 1 张 → 图生视频

images 2 张 → 首尾帧生视频

metadata.action = motionControl → 运动控制

metadata.action = videoExtend → 视频延长

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

文生视频图生视频(首尾帧)视频延长

{
    "model": "V3",
    "prompt": "一只柴犬在樱花树下奔跑",
    "duration": 5,
    "metadata": {
        "aspect_ratio": "16:9",
        "mode": "std",
        "cfg_scale": 0.5,
        "watermark": false
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生视频图生视频(首尾帧)视频延长

curl --location '/v1/videos/kling' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "V3",
    "prompt": "一只柴犬在樱花树下奔跑",
    "duration": 5,
    "metadata": {
        "aspect_ratio": "16:9",
        "mode": "std",
        "cfg_scale": 0.5,
        "watermark": false
    }
}'

返回响应

🟢200

application/json

任务创建成功

Bodyapplication/json

示例

{
    "id": "task_xxxxxxxxx",
    "task_id": "task_xxxxxxxxx",
    "status": "queued",
    "model": "V3",
    "created_at": 1779243291
}

修改于 2026-05-20 06:59:04

拉取视频流(代理)

查询任务状态