Kling
视频特效
DeerAPI Kling 视频特效指南：用模板特效而不是自由生成的方式快速接入 effects，并明确 effect_scene、input、查询与回调的配合。
POST
/
kling
/
v1
/
videos
/
effects
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/effects \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"effect_scene": "hug",
"input": {
"model_name": "kling-v1-6",
"duration": "5",
"image": "https://example.com/effect-source.png"
},
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}这是一条模板型特效接口。先选
effect_scene 再喂素材，比一开始堆很长的 prompt 更稳定。这页最适合什么场景
- 你想快速套用拥抱、亲吻、魔法球这类已有模板效果。
- 你已经有一张图或一段基础素材，只需要让它落进 Kling 预设特效。
- 你要做的是“模板特效”，不是完全自由的视频编辑。
一次最稳的调用顺序
再决定拿结果的方式
想自己轮询时，走 查询任务。想让服务端主动通知，就在创建时加
callback_url，再看 Callback 协议。kling_effects 是 DeerAPI 的 capability ID。如果 input 子对象里还需要 model_name，那仍然是官方 Kling 模型名，两个概念不要混用。effect_scene 和 input 分别负责什么
effect_scene负责告诉系统你要套哪一个模板。input负责放素材、时长，以及模板还要求的其他控制字段。- 如果官方特效中心更新了新模板，优先先在官方页面确认模板名字和素材要求，再回到 DeerAPI 调用。
调试失败时先查什么
- 模板名是否真的存在于当前官方特效中心。
- 素材格式和尺寸是否符合该模板要求。
- 你是不是把 capability ID 写进了
input.model_name。
相关页面
查询任务
任务提交后，最常见的查询组合是
videos/effects。Callback 协议
不想轮询时，把结果回推到你自己的服务端。
Kling 官方视频特效文档
核对 effect_scene 和输入要求时优先看这里。
Kling 特效中心说明
浏览模板列表和场景案例时看这一页更直观。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Body
application/json
当前页面以 effect_scene 选择模板；如果 input 子对象里传 model_name，请继续把它视为官方 Kling 模型字段。
场景名称
Available options:
fuzzyfuzzy, squish, expansion, hug, kiss, heart_gesture 本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知
自定义任务ID，用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性
⌘I
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/effects \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"effect_scene": "hug",
"input": {
"model_name": "kling-v1-6",
"duration": "5",
"image": "https://example.com/effect-source.png"
},
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}