创建图生视频任务

基于图片和文本提示生成视频。支持多种高级功能：

核心功能:

图片到视频转换

尾帧控制（image_tail）

运动笔刷控制

摄像机运动控制

运动笔刷:

static_mask: 静态笔刷，标记静止区域

dynamic_masks: 动态笔刷，为指定区域添加运动轨迹

请求参数

Body 参数application/json

model_name

enum<string>

使用的模型版本

可选

枚举值:

kling-v1kling-v1-5kling-v1-6kling-v2-master

默认值:

kling-v1

image

string

必需

参考图像，支持图片Base64编码或图片URL

示例值:

https://example.com/image.jpg

image_tail

string

可选

参考图像-尾帧控制，支持图片Base64编码或图片URL

prompt

string

正向文本提示词

可选

<= 2500 字符

negative_prompt

string

负向文本提示词

可选

<= 2500 字符

cfg_scale

number

生成视频的自由度

可选

>= 0<= 1

默认值:

0.5

mode

enum<string>

生成模式

可选

枚举值:

stdpro

默认值:

std

static_mask

string

静态笔刷涂抹区域

可选

dynamic_masks

array[object (DynamicMask) {2}]

动态笔刷配置列表

可选

mask

string

动态笔刷涂抹区域

可选

trajectories

array [object {2}]

运动轨迹坐标序列

可选

camera_control

object (CameraControl)

摄像机运动控制

可选

type

enum<string>

预定义的运镜类型

可选

枚举值:

simpledown_backforward_upright_turn_forwardleft_turn_forward

config

object

可选

摄像机运动配置（当type为simple时必填）

duration

enum<string>

视频时长（秒）

可选

枚举值:

510

默认值:

callback_url

string <uri>

任务结果回调地址

可选

external_task_id

string

自定义任务ID

可选

示例

基础图生视频高级图生视频（含运动控制）

{
    "model_name": "kling-v1",
    "image": "https://example.com/image.jpg",
    "prompt": "让图片中的人物缓缓转头微笑",
    "mode": "std",
    "duration": "5"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

任务创建成功

Body

code

integer

错误码

可选

message

string

错误信息

可选

request_id

string

请求ID

可选

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",
    "data": {
        "task_id": "string",
        "task_info": {
            "external_task_id": "string"
        },
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}