Kling AI 文本转视频
概述
使用 /v1/videos/text2video 接口从文本提示生成视频。支持 v1 到 v2.6 模型、标准/专业模式、摄像机控制、负向提示以及原生音频(v2.6+)。
端点: POST https://api.klingai.com/v1/videos/text2video
请求参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
model_name | 字符串 | 是 | 模型版本(参见模型目录) |
prompt | 字符串 | 是 | 视频描述,最多 2500 字符 |
negative_prompt | 字符串 | 否 | 要在生成中排除的内容 |
duration | 字符串 | 是 | "5" 或 "10" 秒 |
aspect_ratio | 字符串 | 否 | "16:9"(默认)、"9:16"、"1:1" 等 |
mode | 字符串 | 否 | "standard"(默认)或 "professional" |
cfg_scale | 浮点数 | 否 | 提示遵循度(0.0-1.0,默认 0.5) |
camera_control | 对象 | 否 | 摄像机运动配置 |
callback_url | 字符串 | 否 | 完成通知的 Webhook URL |
完整示例 — Python
import jwt, time, os, requests
BASE = "https://api.klingai.com/v1"
def get_headers():
ak, sk = os.environ["KLING_ACCESS_KEY"], os.environ["KLING_SECRET_KEY"]
token = jwt.encode(
{"iss": ak, "exp": int(time.time()) + 1800, "nbf": int(time.time()) - 5},
sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"}
)
return {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
# 创建文本转视频任务
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Aerial drone shot of a coral reef at golden hour, "
"tropical fish swimming through crystal clear water, "
"sun rays penetrating the surface, cinematic 4K",
"negative_prompt": "blurry, low quality, distorted, watermark",
"duration": "5",
"aspect_ratio": "16:9",
"mode": "professional",
"cfg_scale": 0.5,
})
task = response.json()
task_id = task["data"]["task_id"]
# 轮询等待完成
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/text2video/{task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
video = result["data"]["task_result"]["videos"][0]
print(f"视频 URL: {video['url']}")
print(f"时长: {video['duration']}s")
break
elif status == "failed":
raise RuntimeError(result["data"]["task_status_msg"])
# else: submitted/processing — keep polling
带摄像机控制
# 摄像机运动类型:pan, tilt, zoom, roll
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "A medieval castle on a cliff at sunrise, fog in the valley",
"duration": "5",
"mode": "standard",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 5, # 向右平移(负值向左),范围 -10 到 10
"vertical": 0, # 倾斜(负值向下,正值向上)
"zoom": 3, # 放大(正值)或缩小(负值)
"roll": 0, # 旋转
"pan": 0, # 左右移动
"tilt": -2, # 上下移动
}
},
})
规则: 对于 type: "simple",config 中只能有一个非零字段。
带原生音频(仅 v2.6)
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "A jazz band performing in a dimly lit club, saxophone solo, "
"audience clapping, warm amber lighting",
"duration": "10",
"mode": "professional",
"motion_has_audio": True, # 生成同步音频
})
提示工程技巧
| 技巧 | 示例 |
|---|---|
| 场景 + 动作 + 风格 | "A samurai walking through cherry blossoms, cinematic slow motion" |
| 光线提示 | "golden hour", "neon-lit", "overcast diffused light" |
| 镜头语言 | "close-up", "wide establishing shot", "tracking shot" |
| 负向提示 | "blurry, watermark, text overlay, distorted faces" |
| 材质/纹理 | "brushed steel", "hand-painted watercolor", "photorealistic" |
成本参考
| 时长 | 标准 | 专业 |
|---|---|---|
| 5 秒 | 10 积分 | 35 积分 |
| 10 秒 | 20 积分 | 70 积分 |
错误处理
| 错误 | 原因 | 修复 |
|---|---|---|
400 无效提示 | 为空或超过 2500 字符 | 检查提示长度 |
400 无效模型 | 不支持的 model_name | 从目录使用有效的模型 ID |
402 积分不足 | 积分不够 | 为账户充值 |
task_status: failed | 内容政策违规或过于复杂 | 简化提示,移除受限内容 |
前提条件
- 已批准的简要说明、权利已清理或合成的参考材料、已授权的 workspace 和预算、内容政策审查、以及用于发布和移除的指定负责人。
操作说明
- 根据已批准的简要说明创建沙盒草稿;不要在提示或上传内容中包含个人、受保护材料或未经核实的声明。
- 在提交前核实请求的时长、风格、目标、积分预算、内容政策状态以及仅限草稿设置。
- 审查带水印的测试渲染结果,确保符合政策、权利和质量要求;如果发现政策或归属问题,立即停止并删除草稿,而非发布。
- 仅在得到负责人批准后发布,并保留经过编辑的生产收据;在批准的保留期限到达后移除临时资产。
输出
生成包含以下内容的渲染收据:简要 ID、批准的来源分类、模型/模式、时长、积分估算、政策和权利审查结果、草稿目标、审批人、保留/移除参考以及任务 ID。排除提示文本、身份信息和凭证。
示例
brief=synthetic-product-demo; source=rights-cleared; mode=standard; duration=5s; policy=pass; destination=draft-only; approval=pending; cleanup=24h 是一个安全的测试请求。