创建 Omni-Video 任务

POST

/kling/v1/videos/omni-video

创建 Omni-Video 异步任务。成功返回 data.task_id，随后使用 GET /kling/v1/videos/omni-video/{task_id} 查询结果。

当前网关会同步返回上游创建任务结果，同时后台按任务查询接口轮询最终状态，用 data.final_unit_deduction 做最终结算。

常见用法：

prompt 中通过 <<<image_1>>>、<<<element_1>>>、<<<video_1>>> 引用图片、主体或视频

image_list 传参考图片或首尾帧

element_list 传主体库 ID

video_list 传参考视频或待编辑视频

multi_shot=true 时可使用 shot_type 和 multi_prompt 控制多镜头

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

图片参考生成自定义多镜头视频编辑 / 视频参考

使用图片作为参考，在 prompt 中通过 <<<image_1>>> 指定图片。

{
    "model_name": "kling-video-o1",
    "prompt": "让<<<image_1>>>中的人物向镜头挥手，表情自然，背景保持不变",
    "image_list": [
        {
            "image_url": "https://cdn.example.com/ref/person.png"
        }
    ],
    "duration": "5",
    "mode": "pro",
    "aspect_ratio": "16:9",
    "sound": "off",
    "watermark_info": {
        "enabled": false
    },
    "external_task_id": "omni-img-20260526-001"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

图片参考生成自定义多镜头视频编辑 / 视频参考

curl --location '/kling/v1/videos/omni-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-video-o1",
    "prompt": "让<<<image_1>>>中的人物向镜头挥手，表情自然，背景保持不变",
    "image_list": [
        {
            "image_url": "https://cdn.example.com/ref/person.png"
        }
    ],
    "duration": "5",
    "mode": "pro",
    "aspect_ratio": "16:9",
    "sound": "off",
    "watermark_info": {
        "enabled": false
    },
    "external_task_id": "omni-img-20260526-001"
}'

返回响应

🟢200

application/json

任务创建成功；只表示任务已经进入队列，不代表视频已经生成完成。

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "request_id": "6f2d9f8a-6d66-4a86-99dd-1a9c7a1d44e4",
    "data": {
        "task_id": "CjZq5k5q8p7v9x2y",
        "task_info": {
            "external_task_id": "omni-img-20260526-001"
        },
        "task_status": "submitted",
        "created_at": 1779772800000,
        "updated_at": 1779772800000
    }
}

🟠400ErrorResponse

🟠401ErrorResponse

🟠403ErrorResponse

🟠404ErrorResponse

🔴500ErrorResponse

修改于 2026-05-25 16:47:15

即梦视频生成

查询 Omni-Video 单个任务