Kling AI 影片延伸 是做什麼的?
概述
通過附加額外的秒數來延長現有影片。延伸端點接收已完成的影片的 task_id,並生成無縫的延續內容。
端點: POST https://api.klingai.com/v1/videos/video-extend
請求參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
task_id | string | 是 | 已完成來源影片的任務 ID |
prompt | string | 否 | 延伸的動作/場景描述 |
duration | string | 否 | 延伸長度:"5"(預設) |
mode | string | 否 | "standard" 或 "professional" |
model_name | string | 否 | 預設值:"kling-v2-master" |
callback_url | string | 否 | 完成時的 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_url}")
break
elif result["data"]["task_status"] == "failed":
print(f"失敗:{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 狀態 |
| 延伸失敗 | 提示詞與來源衝突 | 讓延伸提示詞與原始場景保持一致 |
先決條件
- 已完成且版權已清除或合成的來源草稿、已批准的延伸簡報、已授權的工作區與點數預算、政策審查、僅限草稿的目標、以及一個可回滾/移除的負責人。
操作說明
- 在建立延伸之前,確認來源所有權、完成狀態及已批准的連續性簡報;請勿使用私人、未授權或受政策限制的素材。
- 在批准的長度和點數上限內提交一個帶浮水印的草稿測試,然後驗證政策、版權、品質和目標控制。
- 若遇到連續性、政策、版權或預算偏離,立即暫停並刪除延伸任務,不要發布。
- 僅在獲得所有者批准後才進行推廣;保留一份經過編輯的收據,並在約定的保留期限後移除臨時資產。
輸出
生成一份延伸收據,內容包含來源任務參考、版權分類、模式/長度、點數估算、政策審查、草稿目標、批准人、保留/移除參考以及任務 ID。排除提示詞、身份資訊和資產 URL。
範例
source=synthetic-task-42; rights=cleared; duration=5s; mode=standard; policy=pass; destination=draft-only; cleanup=24h 可以安全進行審查。