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

提交Kling文生视频任务

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

我的收藏

本页目录：

1. 接口描述

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

通过提交对视频内容的描述文本生成一个短视频。文生视频为异步处理任务，成功提交任务后返回任务的JobId。

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

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

2. 输入参数

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

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

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


示例值：一只兔子在草地奔跑
Model 否 String

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


示例值：v1.6
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：std、pro。
  • v2.0、v3.0：模型无需配置。
  • v2.5：首尾帧情况下支持pro。
  • v2.6：仅支持pro，选择v2.6模型时，默认自动生成高品质pro视频。

示例值：std
CfgScale 否 Float

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


示例值：0.5
AspectRatio 否 String

生成视频的画面纵横比（宽:高）
枚举值：16:9, 9:16, 1:1
默认值：16:9


示例值：16:9
Sound 否 String

生成视频时是否同时生成声音

  • 枚举值：on，off

仅V2.6及后续版本模型支持当前参数，v2.6模型的std模式只能生成无声的视频


示例值：off
LogoAdd 否 Integer

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


示例值：0
LogoParam 否 LogoParam

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

是否生成多镜头视频

  • 当前参数为true时，prompt参数无效
  • 当前参数为false时，shot_type参数及multi_prompt参数无效

示例值：true
ShotType 否 String

分镜方式

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


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

各分镜提示词，可包含正向描述和负向描述

通过index、prompt、duration参数定义分镜序号及相应提示词和时长，其中：

  • 最多支持6个分镜，最小支持1个分镜
  • 每个分镜相关内容的最大长度不超过512
  • 每个分镜的时长不大于当前任务的总时长，不小于1
  • 所有分镜的时长之和等于当前任务的总时长
  • 当MultiShot参数为true且ShotType参数为customize时，当前参数不得为空
    用key:value承载，如下：
     "MultiPrompt":[              {                "Index":int,              "Prompt": "string",              "Duration": "5"            }  ]
CameraControl 否 CameraControl

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

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


示例值：https://callback.com

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: SubmitTextToVideoJob
<公共请求参数>

{
    "Prompt": "一只兔子在草原上奔跑"
}

输出示例

{
    "Response": {
        "JobId": "1339558839695589376",
        "RequestId": "e44cc7dc-7e0f-4c45-bfd6-48d817130edd"
    }
}

5. 开发者资源

腾讯云 API 平台

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

API Inspector

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

SDK

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

命令行工具

6. 错误码

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

中国站