文生视频 - Chat Bp

请求参数

Header 参数

Authorization

string

必需

默认值:

Body 参数application/json

model

string

模型

可选

默认值：kling-v1

prompt

string

描述词

必需

正向文本提示，必须，不能超过500个字符

negative_prompt

string

负向描述词

可选

负向文本提示，可选，不能超过200个字符

cfg_scale

number

自由度

可选

生成视频的自由度，可选，值越大，相关性越强，取值范围：[0,1]

mode

string

视频模式

可选

生成视频的模式，可选，枚举值：std（高性能）或 pro（高表现）

camera_control

object

摄像机运动协议

可选

控制摄像机运动的协议，可选，未指定则智能匹配

type

string

可选

可选值simple，down_back，forward_up，right_turn_forward，left_turn_forward

config

object

可选

包含六个字段，用于指定摄像机的运动或变化。当运镜类型指定simple时必填，指定其他类型时不填

aspect_ratio

string

画面纵横比

可选

生成视频的画面纵横比，可选，枚举值：16:9, 9:16, 1:1

duration

string

生成视频时长

可选

生成视频时长，单位秒，可选，枚举值：5，10

callback_url

string

回调地址

可选

本次任务结果回调通知地址，可选

示例

{
    "prompt": "sunsame",
    "negative_prompt": "",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9",
    "cfg_scale": 0,
    "camera_control": {
        "type": "simple",
        "config": {
            "horizontal": 1
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/kling/v1/videos/text2video' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "sunsame",
    "negative_prompt": "",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9",
    "cfg_scale": 0,
    "camera_control": {
        "type": "simple",
        "config": {
            "horizontal": 1
        }
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

request_id

string

必需

data

object

必需

task_id

string

必需

task_status

string

必需

created_at

integer

必需

updated_at

integer

必需

示例

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