Skip to content

Kling 文生视频

使用 Kling 模型从文本描述生成视频。

推荐使用 Omni 端点

对于 kling-v3kling-video-o1 模型,建议使用 Omni 全能视频 端点,支持更丰富的功能(多镜头、视频编辑、原生音频等)。本端点主要适用于 kling-v1 / kling-v1-5 / kling-v1-6 等旧版模型。

接口详情

1. 提交文生视频任务

接口地址: POST /kling/v1/videos/text2video

功能描述: 提交一个视频生成任务。视频生成是异步过程,提交成功后会返回 task_id,之后需要通过查询接口获取结果。

认证方式: Bearer Token

http
Authorization: Bearer YOUR_API_TOKEN

请求参数

Body 参数

参数名类型必填默认值说明示例
modelstring-使用的模型 ID。支持 kling-v1, kling-v1-5, kling-v1-6, kling-v2-1, kling-v2-5-turbo, kling-v2-6, kling-v3kling-v1
promptstring-视频描述文本一只在森林里奔跑的小鹿
image_tailstring-尾帧图片 URL 或 Base64 编码,用于指定视频结束画面https://example.com/end.jpg
negative_promptstring-负向提示词模糊, 水印
cfg_scalefloat5.0提示词相关性0.0 - 100.0
modestringstd生成模式std (标准), pro (专业)
aspect_ratiostring16:9视频比例16:9, 9:16, 1:1
durationstring5视频时长(秒)5, 10

响应参数

参数名类型说明
codeinteger状态码 (0 表示成功)
messagestring提示信息
dataobject数据对象
data.task_idstring任务 ID,用于后续查询结果
data.task_statusstring任务状态 (submitted, processing, succeed, failed)

2. 查询任务结果

接口地址: GET /kling/v1/videos/text2video/:task_id

响应示例:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "xxx",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/video.mp4",
          "duration": "5"
        }
      ]
    }
  }
}

代码示例

Curl 示例

bash
# 1. 提交任务
curl https://api.ezmodel.cloud/kling/v1/videos/text2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "kling-v1",
    "prompt": "一只在森林里奔跑的小鹿",
    "mode": "std",
    "aspect_ratio": "16:9",
    "duration": "5"
  }'

# 2. 查询结果 (替换 TASK_ID)
curl https://api.ezmodel.cloud/kling/v1/videos/text2video/TASK_ID \
  -H "Authorization: Bearer $YOUR_API_KEY"

企业合作联系:service@ezmodel.cloud