Kling AI 视频扩展 是做什么的?
概述
通过追加额外的秒数来扩展现有视频。扩展接口接收已完成视频的 task_id,并生成无缝的延续内容。
端点: POST https://api.klingai.com/v1/videos/video-extend
请求参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
task_id | 字符串 | 是 | 已完成源视频的任务 ID |
prompt | 字符串 | 否 | 扩展部分的运动/场景描述 |
duration | 字符串 | 否 | 扩展长度:"5"(默认值) |
mode | 字符串 | 否 | "standard" 或 "professional" |
model_name | 字符串 | 否 | 默认值:"kling-v2-master" |
callback_url | 字符串 | 否 | 完成回调的 Webhook |
基本扩展
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"}
# 第1步:生成初始的5秒视频
initial = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "A rocket launching from a desert landscape, cinematic",
"duration": "5",
"mode": "standard",
}).json()
initial_task_id = initial["data"]["task_id"]
# 等待完成...
# (轮询直到 task_status == "succeed")
# 第2步:延长 5 秒
extension = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": initial_task_id,
"prompt": "The rocket ascends through clouds into the stratosphere",
"duration": "5",
"mode": "standard",
}).json()
ext_task_id = extension["data"]["task_id"]
# 第3步:轮询扩展任务
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/video-extend/{ext_task_id}", headers=get_headers()
).json()
if result["data"]["task_status"] == "succeed":
extended_url = result["data"]["task_result"]["videos"][0]["url"]
print(f"Extended video: {extended_url}")
break
elif result["data"]["task_status"] == "failed":
print(f"Failed: {result['data']['task_status_msg']}")
break
链式多次扩展
def chain_extensions(initial_task_id: str, prompts: list[str],
duration: str = "5", mode: str = "standard") -> list[str]:
"""链式多次扩展以构建更长的视频。"""
current_task_id = initial_task_id
video_urls = []
for i, prompt in enumerate(prompts):
print(f"扩展 {i + 1}/{len(prompts)}:提交中...")
# 提交扩展
r = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": current_task_id,
"prompt": prompt,
"duration": duration,
"mode": mode,
}).json()
ext_task_id = r["data"]["task_id"]
# 轮询直至完成
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/video-extend/{ext_task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
url = result["data"]["task_result"]["videos"][0]["url"]
video_urls.append(url)
current_task_id = ext_task_id # 下一次扩展从此链式衔接
print(f"扩展 {i + 1} 完成:{url}")
break
elif status == "failed":
raise RuntimeError(f"扩展 {i + 1} 失败:{result['data']['task_status_msg']}")
return video_urls
用法:构建一个 20 秒的视频
# 生成初始的 5 秒视频
initial_r = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Morning sunrise over a mountain lake, mist rising",
"duration": "5",
"mode": "standard",
}).json()
initial_id = initial_r["data"]["task_id"]
# ... 轮询直至完成 ...
# 再链式扩展 3 次 = 5 + 5 + 5 + 5 = 总共 20 秒
extensions = chain_extensions(initial_id, [
"Sun rises higher, birds begin flying across the lake",
"A deer approaches the water's edge to drink",
"Wide shot pulling back to reveal the full mountain range",
])
费用
每次扩展的费用与一次新的生成相同:
| 扩展时长 | 标准 | 专业 |
|---|---|---|
| 5 秒 | 10 积分 | 35 积分 |
一个 20 秒的视频(初始 + 3 次扩展)在标准模式下消耗 40 积分。
错误处理
| 错误 | 原因 | 修复 |
|---|---|---|
无效的 task_id | 源任务不存在 | 验证 task_id 是否来自一个已完成的生成任务 |
| 源未完成 | 正在扩展一个仍在处理中的任务 | 等待源任务达到 succeed 状态 |
| 扩展失败 | 提示词与源冲突 | 使扩展提示词与原始场景保持一致 |
前提条件
- 一个已完成、版权已清除或合成的源草稿、经批准的扩展简报、已授权的 workspace 和积分预算、政策审查、仅限草稿的目标,以及一个回滚/移除负责人。
操作说明
- 在创建扩展之前,确认源视频的所有权、完成状态和批准的连续性简报;不要使用私有、未经许可或受政策限制的材料。
- 在批准的时长和积分上限内提交一个带水印的草稿代表任务,然后验证政策、权利、质量和目标控制。
- 如果出现连续性、政策、权利或预算偏离,立即停止并删除扩展任务,而不是发布它。
- 仅在获得所有者批准后才进行推广;保留一份脱敏收据,并在约定的保留期限后删除临时资产。
输出
生成一份扩展收据,其中包含源任务参考、权利分类、模式/时长、积分估算、政策审查、草稿目标、审批人、保留/删除参考以及任务 ID。排除提示词、身份信息和资产 URL。
示例
source=synthetic-task-42; rights=cleared; duration=5s; mode=standard; policy=pass; destination=draft-only; cleanup=24h 可安全用于审查。