- 前言(必读)
- OpenAI官方SDK使用教程
- 批量请求示例
- 聊天模型(Chat)
- 内容审查
- 向量嵌入
- 图片处理
- 音频模型(Audio)
- 绘画模型(Painting)
- 视频模型(Video)
- 视频模型说明
- 快手可灵AI
- vidu视频
- luma视频
- runway 官方API
- runway 旧版API
- pika视频
- 数字人
- 音乐创作(suno)
- 文档处理
- 3D模型
- 更多接口开发中...
- 查询令牌用量GET
- 查询令牌限额GET
任务:视频特效-双人互动
POST
/kling/v1/videos/effects
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token示例:
Authorization: Bearer ********************
Body 参数application/json
根据 effect_scene 实现不同的特效效果。
- 单图特效:fuzzyfuzzy、squish、expansion
- 双人互动特效:hug、kiss、heart_gesture
effect_scene
enum<string>
场景名称
枚举值:
hugkissheart_gesture
input
object
任务输入结构体
model_name
enum<string>
模型名称
枚举值:
kling-v1kling-v1-5kling-v1-6
images
string
必需
该服务包含合照功能,即用户上传两张人想图,可灵AI将自适应拼接为合照,如图所示先后上传
"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"
得到合照的效果为:

支持传入图片Base64编码或图片URL(确保可访问)
请注意,若您使用base64的方式,请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时,请不要在Base64编码字符串前添加任何前缀,例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。
示例:
正确的Base64编码参数:
1
iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
错误的Base64编码参数(包含data:前缀):
1
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
请仅提供Base64编码的字符串部分,以便系统能够正确处理和解析您的数据。
图片格式支持.jpg / .jpeg / .png
图片文件大小不能超过10MB,图片分辨率不小于300*300px,图片宽高比要在1:2.5 ~ 2.5:1之间
duration
enum<string>
视频时长
枚举值:
510
mode
string
视频模式
其中std:标准模式(标准),基础模式,性价比高
其中pro:专家模式(高品质),高表现模式,生成视频质量更佳
callback_url
string
任务结果回调通知地址
external_task_id
string
自定义任务 ID
示例
{
"effect_scene": "kiss",
"input": {
"model_name": "kling-v1-6",
"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": "5"
}
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.gpt.ge/kling/v1/videos/effects' \
--header 'Content-Type: application/json' \
--data-raw '{
"effect_scene": "kiss",
"input": {
"model_name": "kling-v1-6",
"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": "5"
}
}'
返回响应
🟢200成功
application/json
Body
code
integer
必需
message
string
错误信息
request_id
string
必需
data
object
必需
task_id
string
任务ID,系统生成
task_info
object
必需
task_status
string
必需
created_at
integer
必需
updated_at
integer
必需
示例
{
"code": 0, //错误码;具体定义见错误码
"message": "string", //错误信息
"request_id": "string", //请求ID,系统生成,用于跟踪请求、排查问题
"data":{
"task_id": "string", //任务ID,系统生成
"task_info":{ //任务创建时的参数信息
"external_task_id": "string" //客户自定义任务ID
},
"task_status": "string", //任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"created_at": 1722769557708, //任务创建时间,Unix时间戳、单位ms
"updated_at": 1722769557708 //任务更新时间,Unix时间戳、单位ms
}
}
修改于 2025-04-17 17:33:49