文档中心 / 可灵官方Kling / 可灵 Kling 图生视频 API 文档

可灵 Kling 图生视频 API 文档

推荐看官方文档

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

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

接口说明

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

基础概念

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

接口地址

POST https://api.kaifamiao.com/kling/v1/videos/image2video

请求参数

参数名 类型 必填 说明
model_name string 是 模型版本，固定值"kling-v1-6"
mode string 是 生成模式，"std"为标准模式
prompt string 否 文本提示词
aspect_ratio string 否 视频比例，默认"16:9"
duration string 否 视频时长(秒)，默认"5"
negative_prompt string 否 负面提示词
cfg_scale float 否 提示词相关性，默认0.5
image string 是 参考图片URL

请求头

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

Python示例代码

import json
import requests

# API配置
url = "https://api.kaifamiao.com/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())

响应示例

{
  "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
  }
}

响应字段说明

字段 类型 说明
code int 状态码(0表示成功)
message string 状态信息
request_id string 请求唯一ID
data.task_id string 任务ID
data.task_status string 任务状态
data.created_at timestamp 创建时间戳

错误码

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

官方文档

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