视频特效
POST
/kling/v1/videos/effects
网站中的模型与调用示例
视频特效
单图特效：快来惹毛我fuzzyfuzzy、捏捏乐squish、万物膨胀expansion
双人互动特效： 3款，拥抱hug、亲吻kiss、比心heart_gesture
具体参数请看官方文档：https://app.klingai.com/cn/dev/document-api/apiReference/model/videoEffects
对接时，仅需将请求域名、API key 改成我们，
请求参数
{
"contentType": "application/json",
"properties": {
"effect_scene": {
"title": "场景名称",
"type": "string"
},
"input": {
"properties": {
"duration": {
"description": "枚举值：5，10",
"title": "生成视频时长，单位s",
"type": "string"
},
"images": {
"items": {
"type": "string"
},
"title": "参考图像组",
"type": "array"
},
"mode": {
"description": "枚举值：std，pro\n其中std：标准模式（标准），基础模式，性价比高\n其中pro：专家模式（高品质），高表现模式，生成视频质量更佳",
"title": "生成视频的模式",
"type": "string"
},
"model_name": {
"description": "枚举值：kling-v1, kling-v1-5, kling-v1-6\nfight 仅支持 kling-v1-6\nhug, kiss, heart_gesture支持 kling-v1, kling-v1-5, kling-v1-6\n仅双人特效需要传model_name",
"title": "模型名称",
"type": "string"
}
},
"required": [
"images",
"duration"
],
"type": "object"
}
},
"required": [
"effect_scene",
"input"
]
}请求示例 · 示例 1
{
"effect_scene": "hug",
"input": {
"duration": "5",
"images": [
"https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
"https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
],
"mode": "std",
"model_name": "kling-v1-6"
}
}响应示例 · 成功示例
{
"code": 0,
"data": {
"created_at": 1762419982549,
"task_id": "815336894036197446",
"task_info": {},
"task_status": "submitted",
"updated_at": 1762419982549
},
"message": "SUCCEED",
"request_id": "8241f535-7462-4ea4-849a-e287081bc296"
}视频特效
请求参数
{
"contentType": "application/json",
"properties": {
"callback_url": {
"type": "string"
},
"effect_scene": {
"description": "场景名称",
"type": "string",
"x-i18n": {
"en-US": {
"description": "scene name"
}
}
},
"external_task_id": {
"type": "string"
},
"input": {
"description": "参考图像 支持传入图片Base64编码或图片URL（确保可访问）支持不同任务输入的结构体 根据scene不同，结构体里传的字段不同，具体如「场景请求体」所示",
"properties": {
"image": {
"description": "单人 ",
"type": "string",
"x-i18n": {
"en-US": {
"description": "single person"
}
}
},
"images": {
"description": "双人 ",
"items": {
"type": "string"
},
"type": "array",
"x-i18n": {
"en-US": {
"description": "two people"
}
}
}
},
"type": "object",
"x-i18n": {
"en-US": {
"description": "Reference image (Base64 or reachable URL). Payload shape varies by scene; see scene request bodies"
}
}
}
},
"required": [
"effect_scene"
]
}请求示例 · 示例 1
{
"effect_scene": "pet_lion",
"input": {
"image": "https://p4-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452"
}
}请求参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-10-24 18:33:09