视频特效 - DeerAPI-API文档

本文档不实时更新，完整版请查看官方文档：https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M

curl --location --request POST 'https://api.deerapi.com/kling/v1/videos/effects' \ --header 'Authorization: Bearer {{api-key}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "effect_scene": "hug", "input": { "model_name": "kling-v1-6", "mode": "std", "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" ], "duration": "10" } }'

{ "code": 0, "message": "string", "request_id": "string", "data": { "task_id": "string", "task_status": "string", "created_at": 0, "updated_at": 0 } }

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer {{api-key}}

Body 参数application/json

effect_scene

enum<string>

场景名称

必需

枚举值:

fuzzyfuzzysquishexpansionhugkissheart_gesture

callback_url

string

必需

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

external_task_id

string

必需

自定义任务ID，用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性

input

必需

One of

object

单图特效

object (单人特效)

必需

适用于fuzzyfuzzy、squish、expansion场景

示例

返回响应

🟢200Successful Response

application/json

Body

code

integer

必需

错误码；具体定义错误码

message

string

错误信息

必需

request_id

string

必需

请求ID，系统生成，用于跟踪请求、排查问题

data

object

必需

task_id

string

必需

任务ID，系统生成

task_status

string

必需

任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）

created_at

integer

必需

任务创建时间，Unix时间戳、单位ms

updated_at

integer

必需

任务更新时间，Unix时间戳、单位ms