任务：视频特效-单图

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

根据 effect_scene 实现不同的特效效果。 - 单图特效：fuzzyfuzzy、squish、expansion - 双人互动特效：hug、kiss、heart_gesture

effect_scene

enum<string>

场景名称

必需

特效场景名称

枚举值:

fuzzyfuzzysquishexpansion

input

object

任务输入结构体

必需

支持不同任务输入的结构体。根据 scene 不同，结构体里传的字段不同，具体见「场景请求体」说明。

model_name

enum<string>

模型名称

必需

注意：单人特效仅支持 kling-v1-6

枚举值:

kling-v1-6

image

string

必需

参考图像

支持传入图片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>

视频时长

必需

单位秒

枚举值:

5

callback_url

string

任务结果回调通知地址

可选

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知。具体通知的消息 schema 见“Callback 协议”。

external_task_id

string

自定义任务 ID

可选

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

示例

{
  "effect_scene": "expansion",
  "input": {
    "model_name": "kling-v1-6",
    "image": "https://p1-kling.klingai.com/bs2/upload-ylab-stunt/kling/ai_se/%E8%86%A8%E8%83%80case-%E8%B7%AF%E4%B8%8A%E7%BA%A2%E8%89%B2%E6%B1%BD%E8%BD%A6.jpg?x-kcdn-pid=112452&x-oss-process=image",
    "duration": "5"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.gpt.ge/kling/v1/videos/effects' \
--header 'Content-Type: application/json' \
--data-raw '{
  "effect_scene": "expansion",
  "input": {
    "model_name": "kling-v1-6",
    "image": "https://p1-kling.klingai.com/bs2/upload-ylab-stunt/kling/ai_se/%E8%86%A8%E8%83%80case-%E8%B7%AF%E4%B8%8A%E7%BA%A2%E8%89%B2%E6%B1%BD%E8%BD%A6.jpg?x-kcdn-pid=112452&x-oss-process=image",
    "duration": "5"
  }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

task_id

string

必需

action

string

必需

status

string

必需

fail_reason

string

必需

submit_time

integer

必需

start_time

integer

必需

finish_time

integer

必需

progress

string

必需

data

object

必需

created_at

integer

必需

updated_at

integer

必需

task_result

object

必需

task_status

string

必需

task_status_msg

string

必需

request_id

string

必需

string

必需

示例

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "CmYgjmbyMToAAAAAAF6svw",
  "data": {
    "task_id": "CmYgjmbyMToAAAAAAF6svw",
    "task_status": "submitted",
    "created_at": 1727338013674,
    "updated_at": 1727338013674
  }
}