可灵 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_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示例代码
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
}
}
响应字段说明
字段 | 类型 | 说明 |
---|---|---|
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