创建视频

使用公共字段提交基础参数，并通过 metadata 传递 Kling 专属参数。

POST/v1/video/generations

使用公共 JSON 任务格式创建 Kling 视频。平台会将公共字段映射到 Kling 原生参数，厂商扩展字段放入 metadata。

模型 ID 示例包括 kling-v1、kling-v2-master、kling-v2-6 和 kling-video-o1。实际可用模型以当前 API Key 返回的模型列表为准。

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

Kling 平台格式视频创建请求。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Kling 视频模型 ID，例如 kling-v1、kling-v2-master、kling-v2-6 和 kling-video-o1。实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

正向提示词，最多 2500 个字符。

Lengthlength <= 2500

image?string

参考图片 URL，平台映射到 Kling init_image 并启用图生视频。

size?string

视频尺寸，平台根据宽高映射到 Kling aspect_ratio。

duration?number

视频时长，单位为秒。平台格式支持 5 或 10，并映射到 duration_string。

Value in

metadata?

Kling 厂商扩展参数。非公共字段应放入此对象。

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一只猫咪在舞台上唱歌，电影感",    "size": "1280x720",    "duration": 5  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`