Skip to main content
POST
Image to video
  • 路径 POST /kling/v1/videos/image2video
  • 本页对应官方 Legacy 协议;新版请求请使用 API 2.0
  • 字段详解:请参考官网权威文档
请求参数
重要约束
  • imageimage_tail 至少提供一个;V1.5/V1.6 的 pro 模式支持仅尾帧,其余模型请提供首帧。
  • image + image_taildynamic_masks/static_maskcamera_control 三组选一,互斥不可同时使用;
  • voice_listkling-v2-6 支持,且使用时 sound=on、最多 2 个。
  • kling-v3-omni 请使用 Omni 视频入口 /kling/v1/videos/omni-video
  • 历史输入 kling-v2-5 会归一为 kling-v2-5-turbo;Kling 3.0 Turbo 使用 新版入口,不使用旧版别名。
动态笔刷配置
  • trajectories:运动轨迹坐标序列,以输入图片左下为原点的像素坐标,至少2个点,最多77个点
  • dynamic_masks 最多 6 组;static_maskdynamic_masks.mask 分辨率需与 image 一致,否则上游可能失败

场景一:首帧驱动

场景二:首帧 + 尾帧

场景三:使用摄像机运镜

示例响应

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
aspect_ratio
string

画面纵横比:16:9, 9:16, 1:1

callback_url
string

回调通知地址

camera_control
object

摄像机运动控制

cfg_scale
number

生成视频的自由度 [0, 1]

duration
string

视频时长:5, 10

dynamic_masks
object[]

动态笔刷配置列表(最多6组)

element_list
object[]
external_task_id
string

自定义任务ID

image
string

图片URL,必须

image_tail
string

尾帧图片

mode
string

生成模式:std, pro

model_name
string

模型名称,默认kling-v1

multi_prompt
object[]
multi_shot
boolean
negative_prompt
string

负向文本提示词

prompt
string

文本提示词

shot_type
string
sound
string

是否生成声音:on/off

static_mask
string

静态笔刷涂抹区域

voice_list
object[]

语音列表

watermark_info
object

水印信息

Response

200 - application/json

OK

code
integer

错误码

data
object

单个任务数据

data_list
object[]

任务列表数据(用于列表查询)

message
string

错误信息

request_id
string

请求ID