文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯混元生视频>API 文档>第三方生视频相关接口>提交Kling图生视频任务

提交Kling图生视频任务

最近更新时间：2026-04-16 02:41:48

我的收藏

本页目录：

1. 接口描述

接口请求域名： vclm.tencentcloudapi.com 。

提交视频特效任务接口

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：SubmitImageToVideoJob。
Version 是 String 公共参数，本接口取值：2024-05-23。
Region 是 String 公共参数，详见产品支持的 地域列表。
Model 否 String

模型名称。
v1.6：Kling-V1-6
v2.0：Kling-V2-Master
v2.1：Kling-V2-1
v2.5：Kling-V2-5-Turbo
v2.6：Kling-V2-6
V3.0：kling-v3


示例值：v1.6
Image 否 Image

参考图像。

  • 支持传入图片Base64编码或图片URL（确保可访问）
  • 图片文件大小不能超过10MB，图片分辨率不小于300*300px，图片宽高比要在1:2.5 ~ 2.5:1之间
  • Image 参数与 ImageTail 参数至少二选一，二者不能同时为空
  • 图片格式支持.jpg / .jpeg / .png
ImageTail 否 Image

参考尾帧图像。

  • 支持传入图片Base64编码或图片URL（确保可访问）
  • 图片文件大小不能超过10MB，图片分辨率不小于300*300px，图片宽高比要在1:2.5 ~ 2.5:1之间
  • Image 参数与 ImageTail 参数至少二选一，二者不能同时为空
  • 图片格式支持.jpg / .jpeg / .png
  • ImageTail参数、DynamicMasks/StaticMask参数、CameraControl参数三选一，不能同时使用
Prompt 否 String

正向文本提示词。不能超过2500个字符


示例值：一只小猫在草地奔跑
NegativePrompt 否 String

负向文本提示词。不能超过2500个字符


示例值：模糊
Duration 否 String

生成视频时长，单位s。默认值为5。
枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15

不同模型支持时长不同

  • 模型v1.6、v2.0、v2.5、v2.6：支持5、10
  • 模型v3.0：支持3～15s

示例值：5
Mode 否 String

生成视频的模式
枚举值：std，pro
其中std：标准模式（标准），基础模式，性价比高
其中pro：专家模式（高品质），高表现模式，生成视频质量更佳

不同模型版本、视频模式支持范围不同

  • v1.6：首尾帧与仅首帧情况下只支持pro
  • v2.0、v3.0 ：无需配置
  • v2.1、v2.5、v2.6：首尾帧情况下只支持pro

示例值：std
CfgScale 否 Float

生成视频的自由度；值越大，模型自由度越小，与用户输入的提示词相关性越强。
v2.0、v2.5、v2.6模型的不支持当前参数
取值范围：[0, 1]


示例值：0.5
Sound 否 String

生成视频时是否同时生成声音
枚举值：on，off
不同模型版本、视频模式支持范围不同

  • v2.6：有首尾帧的pro模式只能生成无声的视频

示例值：off
LogoAdd 否 Integer

为生成视频添加标识的开关，默认为1。
1：添加标识。
0：不添加标识。
其他数值：默认按1处理。
建议您使用显著标识来提示，该视频是 AI 生成的视频。


示例值：1
LogoParam 否 LogoParam

标识内容设置。
默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
MultiShot 否 Boolean

是否生成多镜头视频

  • 当前参数为true时，Prompt参数无效，且不支持设定首尾帧生视频
  • 当前参数为false时，ShotType参数及MultiPrompt参数无效

示例值：true
ShotType 否 String

分镜方式

  • 枚举值：customize，intelligence
  • 当MultiShot参数为true时，当前参数必填

示例值：customize
MultiPrompt.N 否 Array of MultiPrompt

各分镜信息，如提示词、时长等
通过Index、Prompt、Duration参数定义分镜序号及相应提示词和时长，其中：

  • 最多支持6个分镜，最小支持1个分镜
  • 每个分镜相关内容的最大长度不超过512
  • 每个分镜的时长不大于当前任务的总时长，不小于1
  • 所有分镜的时长之和等于当前任务的总时长

用key:value承载，如下：
"MultiPrompt":[
{
"Index":int,
"Prompt": "string",
"Duration": "5"
},
{
"Index":int,
"Prompt": "string",
"Duration": "5"
}
]

  • 当MultiShot参数为true且ShotType参数为customize时，当前参数不得为空
ElementList.N 否 Array of Element

参考主体列表

  • 基于主体库中主体的ID配置，用key:value承载，如下：

      "ElementList":[      {         "ElementId":long    },    {         "ElementId":long    }  ]

  • 最多支持3个参考主体

  • 主体分为视频定制主体（简称：视频角色主体）和图片定制主体（简称：多图主体），适用范围不同，请注意区分

  • 更多主体信息详见：可灵「主体库 3.0」使用指南
StaticMask 否 String

静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）
“运动笔刷”能力包含“动态笔刷 DynamicMasks”和“静态笔刷 StaticMask”两种
支持传入图片Base64编码或图片URL（确保可访问，格式要求同 Image 字段）
图片格式支持.jpg / .jpeg / .png
图片长宽比必须与输入图片相同（即Image字段），否则任务失败（failed）
StaticMask和 DynamicMasks.Mask这两张图片的分辨率必须一致，否则任务失败（failed）


示例值：https://callback.com
DynamicMasks.N 否 Array of DynamicMask

动态笔刷配置列表
可配置多组（最多6组），每组包含“涂抹区域 Mask”与“运动轨迹 Trajectories”序列
CameraControl 否 CameraControl

控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配）
CallbackUrl 否 String

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知


示例值：https://callback.com
VoiceList.N 否 Array of Voice

生成视频时所引用的音色的列表

一次视频生成任务至多引用2个音色
当VoiceList参数不为空且Prompt参数中引用音色ID时，视频生成任务按“有指定音色”计量计费
VoiceId参数值通过音色定制接口返回，也可使用系统预置音色，详见音色定制相关API；非对口型API的VoiceId
ElementList参数与VoiceList参数互斥，不能共存
v3模型不支持指定音色
用key:value承载，如下：
"VoiceList":[
{"VoiceId":"VoiceId_1"},
{"VoiceId":"VoiceId_2"}
]

3. 输出参数

参数名称 类型 描述
JobId String

任务ID。


示例值：1194931538865782784
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 示例

输入示例

POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitImageToVideoJob
<公共请求参数>

{
    "Image": {
        "Url": "https://cqicchen-test-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/neckyang/templatetovideo/downson.png?q-sign-algorithm=sha1&q-ak=*****&q-sign-time=1774494815;1774502015&q-key-time=1774494815;1774502015&q-header-list=host&q-url-param-list=&q-signature=****"
    },
    "CameraControl": {
        "Type": "simple"
    }
}

输出示例

{
    "Response": {
        "JobId": "1428581788753207296",
        "RequestId": "b867e180-074e-4b7d-a275-cc5c0032931c"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见 公共错误码。

中国站