多图参考生视频 - API reference

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Authorization

string

optional

Default:

Body Params application/json

model_name

enum<string>

optional

模型名称

Allowed value:

kling-v1-6

Default:

kling-v1-6

image_list

array [object {1}]

required

最多支持4张图片。API端无裁剪逻辑，请直接上传已选主体后的图片。支持传入图片Base64编码或图片URL（确保可访问）。请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。图片格式支持.jpg / .jpeg / .png。图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间。

<= 4 items

image

string

required

图片URL或Base64编码的图片数据. Base64编码时不应包含 'data:image/png;base64,' 前缀.

prompt

string

optional

正向文本提示词

不能超过2500个字符

<= 2500 characters

negative_prompt

string

optional

负向文本提示词

不能超过2500个字符

<= 2500 characters

mode

enum<string>

optional

生成视频的模式

枚举值：std，pro
其中std：标准模式（标准），基础模式，性价比高
其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
不同模型版本、视频模式支持范围不同，详见当前文档3-0能力地图

Allowed values:

stdpro

Default:

std

duration

enum<string>

optional

生成视频时长，单位s

枚举值：5，10

Allowed values:

510

Default:

5

aspect_ratio

enum<string>

optional

生成图片的画面纵横比（宽:高）

枚举值：16:9, 9:16, 1:1

Allowed values:

16:99:161:1

Default:

16:9

callback_url

string <uri>

optional

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

具体通知的消息schema见“Callback协议”

external_task_id

string

optional

自定义任务ID

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

Example

{
  "model_name": "kling-v1-6",
  "image_list": [
    {
      "image": "image_url"
    },
    {
      "image": "image_url"
    },
    {
      "image": "image_url"
    },
    {
      "image": "image_url"
    }
  ],
  "mode": "std",
  "prompt": "Animate this image, bringing it to life with subtle movements while preserving the original features.",
  "aspect_ratio": "16:9"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/kling/v1/videos/multi-image2video' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model_name": "kling-v1-6",
  "image_list": [
    {
      "image": "image_url"
    },
    {
      "image": "image_url"
    },
    {
      "image": "image_url"
    },
    {
      "image": "image_url"
    }
  ],
  "mode": "std",
  "prompt": "Animate this image, bringing it to life with subtle movements while preserving the original features.",
  "aspect_ratio": "16:9"
}'

Responses

🟢200成功

application/json

Body

code

integer

required

错误码；具体定义错误码

message

string

required

错误信息

request_id

string

required

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

data

object

required

task_id

string

required

任务ID，系统生成

task_status

string

required

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

created_at

integer

required

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

updated_at

integer

required

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

Example

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