可灵Kling 文生视频 API 接口文档
推荐看官方文档
所有格式和参数都和官方文档一致。 仅在调用path前加上/kling
。 我们更新不及时,建议直接查看官方文档
https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice
概念介绍
文生视频(Text-to-Video)是一种通过文本描述生成视频内容的技术。本API基于可灵Kling模型,支持根据文本提示词生成高质量短视频内容。
接口地址
POST https://www.dmxapi.cn/kling/v1/videos/text2video
参数说明
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
model_name | string | 是 | 模型名称,当前固定为"kling-v1-6" |
mode | string | 是 | 生成模式,"std"为标准模式 |
prompt | string | 是 | 文本提示词,描述想要生成的视频内容 |
aspect_ratio | string | 是 | 视频宽高比,如"9:16" |
duration | int | 是 | 视频时长(秒) |
negative_prompt | string | 否 | 负面提示词,不希望出现在视频中的内容 |
cfg_scale | float | 否 | 提示词相关性系数,默认0.5 |
示例代码
python
import json
import requests
# API请求地址
url = "https://www.dmxapi.cn/kling/v1/videos/text2video"
# 替换为您的API密钥
api_key = "sk-****************************" # 此处替换为你的 DMXAPI 令牌
# 构造请求体
payload = json.dumps({
"model_name": "kling-v1-6",
"mode": "std",
"prompt": "科技感的超级旗舰店,大标题写着 DMXAPI", # 视频内容描述
"aspect_ratio": "9:16", # 竖屏视频
"duration": 10, # 10秒视频
"negative_prompt": "", # 负面提示词留空
"cfg_scale": 0.5 # 提示词相关性
})
# 设置请求头
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {api_key}", # 认证头
}
# 发送POST请求
response = requests.request("POST", url, headers=headers, data=payload)
# 打印响应结果
print(response.text)
返回示例
json
{
"code": 0,
"message": "SUCCEED",
"request_id": "08b1741a-561d-447b-a9e2-8033c0cdac7a",
"data": {
"task_id": "784998939837341722",
"task_status": "submitted",
"task_info": {},
"created_at": 1755186850621,
"updated_at": 1755186850621
}
}
响应字段说明
code
: 状态码(0表示成功)message
: 状态信息request_id
: 请求唯一IDdata.task_id
: 任务ID,用于查询结果data.task_status
: 任务状态(submitted/processing/completed/failed)