创建文生视频任务

根据文本提示生成视频。支持多种模型和模式选择，可配置摄像机运动、视频比例等参数。

支持的模型:

kling-v1: 基础版本

kling-v1-5: 改进版本

kling-v1-6: 优化版本

kling-v2-master: 最新版本

生成模式:

std: 标准模式，生成速度快

pro: 专业模式，质量更高但耗时更长

请求参数

Body 参数application/json

model_name

enum<string>

使用的模型版本

可选

枚举值:

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

默认值:

kling-v1

prompt

string

正向文本提示词

必需

<= 2500 字符

示例值:

一只可爱的小猫在花园里玩耍，阳光明媚

negative_prompt

string

负向文本提示词

可选

<= 2500 字符

示例值:

模糊，低质量，变形

cfg_scale

number

可选

生成视频的自由度，值越大模型自由度越小

>= 0<= 1

默认值:

0.5

mode

enum<string>

可选

生成模式（std=标准，pro=专业）

枚举值:

stdpro

默认值:

std

camera_control

object (CameraControl)

摄像机运动控制

可选

type

enum<string>

预定义的运镜类型

可选

枚举值:

simpledown_backforward_upright_turn_forwardleft_turn_forward

config

object

可选

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

aspect_ratio

enum<string>

视频纵横比

可选

枚举值:

16:99:161:1

默认值:

16:9

duration

enum<string>

视频时长（秒）

可选

枚举值:

510

默认值:

callback_url

string <uri>

任务结果回调地址

可选

external_task_id

string

自定义任务ID

可选

示例

基础文生视频高级文生视频（含摄像机控制）

{
    "model_name": "kling-v1",
    "prompt": "一只可爱的小猫在花园里玩耍",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

任务创建成功

Body

code

integer

错误码

可选

示例值:

message

string

错误信息

可选

示例值:

success

request_id

string

请求ID

可选

示例值:

req_123456789

data

object

可选

task_id

string

任务ID

可选

示例值:

task_abc123def456

task_status

string

任务状态

可选

示例值:

submitted

示例

{
    "code": 0,
    "message": "success",
    "request_id": "req_123456789",
    "data": {
        "task_id": "task_abc123def456",
        "task_status": "submitted"
    }
}

🟠400请求有误