Docs/Kling (可灵) 视频特效 API

Kling (可灵) 视频特效 API

136+ 创意视频特效，包括节日主题、动态效果和风格变换。将特效应用于照片，生成精彩视频。

快速开始

从控制台获取 API 密钥

选择特效场景

发送 POST 请求创建任务

轮询 GET 请求获取视频结果

认证方式

在所有请求中添加 Bearer Token 认证头：

Authorization: Bearer YOUR_API_KEY

可用模型

模型	API 名称	特性
Kling 视频特效	`kling-effects`	136+ 创意视频特效, 支持单人和双人

定价 (8.5折)

类别	$	示例
超低	$0.0106	`pet_lion, pet_cat, pet_dog`
低	$0.0181	`santa_gift`
中等 (基础)	$0.0214	`santa_express, balloon_parade`
中高	$0.0373	`bloombloom, dizzydizzy, face_warp`
高	$0.0425	`happy_birthday, birthday_cake`
超高	$0.0745	`bullet_time`

接口端点

POST/api/v1/video/generations

创建可灵特效视频生成任务。将创意特效应用于一张或两张人物照片。

GET/api/v1/video/generations?task_id=xxx

查询任务状态并获取视频链接

请求参数

model必填string

"kling-effects"

effect_scene必填string

特效场景名称，如 "balloon_parade"、"happy_birthday"、"bullet_time"

input必填object

包含图片和选项的输入对象

callback_urlstring

完成后的回调 URL

input 对象字段

imagestring

单人照片 URL 或 base64（用于单人特效）

imagesarray

图片 URL 或 base64 字符串数组（用于双人特效）

model_namestring

双人特效的模型名称，如 "kling-v1-6"

modestring

"std" 或 "pro"，用于双人特效

durationstring

视频时长（秒）

代码示例

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-effects",
    "effect_scene": "balloon_parade",
    "input": {
      "image": "https://example.com/person.jpg"
    }
  }'

响应格式

创建任务响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "pending",
    "model": "kling-video/kling-effects"
  }
}

成功响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "completed",
    "model": "kling-video/kling-effects",
    "resultUrls": ["https://...video.mp4"],
    "createTime": 1705123450000,
    "completeTime": 1705123500000
  }
}

失败响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "failed",
    "model": "kling-video/kling-effects",
    "failMsg": "Content policy violation"
  }
}

任务状态

pending任务已排队，等待处理

processing视频生成中

completed视频生成成功

failed视频生成失败

错误码

400请求错误 - 参数缺失或无效

401未授权 - API 密钥无效

402余额不足 - 积分不够

404未找到 - 任务 ID 不存在

500服务器内部错误

注意事项

*视频文件保存 7 天，请及时下载
*136+ 特效可用，涵盖节日、动态和风格类别
*单人特效使用 "image" 字段，双人特效使用 "images" 数组
*价格因特效类别不同而异，从 $0.0106 到 $0.0745
*建议每 5-10 秒轮询一次状态
*特效场景名称区分大小写

在 Playground 中试用获取 API 密钥

模型

API 名称

特性

Kling 视频特效

kling-effects

136+ 创意视频特效, 支持单人和双人

类别

示例

超低

$0.0106

pet_lion, pet_cat, pet_dog

低

$0.0181

santa_gift

中等 (基础)

$0.0214

santa_express, balloon_parade

中高

$0.0373

bloombloom, dizzydizzy, face_warp

高

$0.0425

happy_birthday, birthday_cake

超高

$0.0745

bullet_time

代码示例

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-effects",
    "effect_scene": "balloon_parade",
    "input": {
      "image": "https://example.com/person.jpg"
    }
  }'

响应格式

创建任务响应

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "pending", "model": "kling-video/kling-effects" } }

成功响应

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "completed", "model": "kling-video/kling-effects", "resultUrls": ["https://...video.mp4"], "createTime": 1705123450000, "completeTime": 1705123500000 } }

失败响应

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "failed", "model": "kling-video/kling-effects", "failMsg": "Content policy violation" } }

注意事项

*视频文件保存 7 天，请及时下载

*136+ 特效可用，涵盖节日、动态和风格类别

*单人特效使用 "image" 字段，双人特效使用 "images" 数组

*价格因特效类别不同而异，从 $0.0106 到 $0.0745

*建议每 5-10 秒轮询一次状态

*特效场景名称区分大小写