文生视频
POST
/kling/v1/videos/text2video
根据文本提示词生成视频任务。
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
model_name
string
Required
模型名称 枚举值:kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v3
prompt
string
正向文本提示词不能超过2500个字符
multi_shot
boolean
Required
是否生成多镜头视频
当前参数为true时,prompt参数无效
当前参数为false时,shot_type参数及multi_prompt参数无效
shot_type
string
分镜方式
枚举值:customize
当multi_shot参数为true时,当前参数必填
multi_prompt
object[]
各分镜信息,如提示词、时长等
● 通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中:
○ 最多支持6个分镜,最小支持1个分镜
○ 每个分镜相关内容的最大长度不超过512
○ 每个分镜的时长不大于当前任务的总时长,不小于1
○ 所有分镜的时长之和等于当前任务的总时长
Expand
negative_prompt
string
负向文本提示词不能超过2500个字符
cfg_scale
number
生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强
mode
string
Required
生成视频的模式
枚举值:std,pro
其中std:标准模式(标准),基础模式,性价比高
其中pro:专家模式(高品质),高表现模式,生成视频质量更佳
sound
string
生成视频时是否同时生成声音
枚举值:on,off
仅V2.6及后续版本模型支持当前参数
aspect_ratio
string
生成视频的画面纵横比(宽:高)
duration
string
Required
生成视频时长,单位s
watermark_info
object
是否同时生成含水印的结果
● 通过enabled参数定义,用key:value承载,如下:
"watermark_info": {
"enabled": boolean // true 为生成,false 为不生成
}
Expand
camera_control
object
控制摄像机运动的协议(如未指定,模型将根据输入的文本/图片进行智能匹配)
Expand
callback_url
string
external_task_id
string
Responses
OK
application/json
object
task_id
string
任务 ID
task_status
string
任务状态