Skip to content

可灵 Kling 图生视频 API 文档

推荐看官方文档

所有格式和参数都和官方文档一致。 仅在调用path前加上/kling。 我们更新不及时,建议直接查看官方文档

https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice

接口说明

本API用于将静态图片转换为动态视频内容,基于可灵Kling AI模型实现。

基础概念

  • 图生视频:通过AI技术将静态图片转化为动态视频内容
  • 任务状态:提交(submitted)、处理中(processing)、完成(completed)、失败(failed)

接口地址

POST https://www.dmxapi.cn/kling/v1/videos/image2video

请求参数

参数名类型必填说明
model_namestring模型版本,固定值"kling-v1-6"
modestring生成模式,"std"为标准模式
promptstring文本提示词
aspect_ratiostring视频比例,默认"16:9"
durationstring视频时长(秒),默认"5"
negative_promptstring负面提示词
cfg_scalefloat提示词相关性,默认0.5
imagestring参考图片URL

请求头

  • Authorization: Bearer ****** (您的API密钥)
  • Content-Type: application/json

Python示例代码

python
import json
import requests

# API配置
url = "https://www.dmxapi.cn/kling/v1/videos/image2video"
api_key = "sk-*******************************"  # 替换为您的实际API密钥

# 请求参数
payload = json.dumps({
    "model_name": "kling-v1-6",  # 固定模型版本
    "mode": "std",  # 标准生成模式
    "prompt": "让书本打开,书里飞出有魔法的感觉",  # 可选文本提示
    "aspect_ratio": "16:9",  # 视频宽高比
    "duration": "5",  # 视频时长(秒)
    "negative_prompt": "",  # 负面提示词
    "cfg_scale": 0.5,  # 提示词相关性系数
    "image": "https://example.com/image.jpg"  # 参考图片URL
})

# 设置请求头
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# 发送请求
response = requests.post(url, headers=headers, data=payload)

# 输出响应
print(response.json())

响应示例

json
{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "3a61925e-d315-49e6-99af-e0b289e6b9dc",
  "data": {
    "task_id": "785014057886679061",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1755190455037,
    "updated_at": 1755190455037
  }
}

响应字段说明

字段类型说明
codeint状态码(0表示成功)
messagestring状态信息
request_idstring请求唯一ID
data.task_idstring任务ID
data.task_statusstring任务状态
data.created_attimestamp创建时间戳

错误码

错误码说明
0成功
400参数错误
401认证失败
500服务器错误

官方文档

https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice

一个 Key 用全球大模型