文生视频

标准文生视频与 Omni/O1 使用同一请求方法和路径，并通过不同请求结构表达输入。

POST/kling/v1/videos/text2video

直接使用 Kling 原生字段。平台负责鉴权与路由，不将 Payload 转换为公共格式。

Omni/O1 复用同一原生创建路径，通过模型和素材字段区分。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Kling 原生文生或 Omni/O1 请求。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Kling 原生模型 ID，例如 kling-v2-5-turbo 和 kling-v2-6。实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

正向提示词，不超过 2500 个字符。

Lengthlength <= 2500

negative_prompt?string

负向提示词。

Lengthlength <= 2500

mode?string

生成模式。V1.6 不支持 pro。

Value in

"std"
"pro"

aspect_ratio?string

输出画面比例。

Default"16:9"

Value in

"16:9"
"9:16"
"1:1"

duration_string?string

视频时长，单位为秒。

Value in

"5"
"10"

cfg_scale?number

提示词一致性强度。

Range0 <= value <= 1

sound?string

是否生成声音。仅 V2.6 及后续模型支持。

Value in

"on"
"off"

voice_list?array<>

引用音色列表。

Itemsitems <= 2

callback?string

任务状态回调地址。

Formaturi

params?string

回调透传参数。

Response Body

`application/json`

curl -X POST "https://example.com/kling/v1/videos/text2video" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一只猫咪在舞台上唱歌，电影感",    "negative_prompt": "模糊，低清晰度",    "mode": "std",    "aspect_ratio": "16:9",    "duration_string": "5",    "cfg_scale": 0.5,    "sound": "on",    "callback": "https://example.com/kling/callback",    "params": "user_id_123"  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`