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": "砂漠の風景からロケットが打ち上げられる、シネマティック",
"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": "ロケットが雲の中を上昇し、成層圏へ",
"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": "山の湖に朝日が昇る、霧が立ち込める",
"duration": "5",
"mode": "standard",
}).json()
initial_id = initial_r["data"]["task_id"]
# ... 完了までポーリング ...
# さらに3回延長 = 5 + 5 + 5 + 5 = 合計20秒
extensions = chain_extensions(initial_id, [
"太陽がさらに高く昇り、鳥が湖の上を飛び始める",
"鹿が水辺に近づき水を飲む",
"ワイドショットで後退し、山脈全体を映す",
])
コスト
各延長は新しい生成と同じコストがかかります:
| 延長時間 | 標準 | プロフェッショナル |
|---|---|---|
| 5秒 | 10 クレジット | 35 クレジット |
20秒の動画(最初の生成 + 3回延長)は、標準モードで40クレジットかかります。
エラーハンドリング
| エラー | 原因 | 修正方法 |
|---|---|---|
無効な task_id | ソースタスクが存在しない | task_id が完了した生成からのものであることを確認 |
| ソースが未完了 | 処理中のタスクを延長しようとした | ソースタスクが succeed 状態になるまで待つ |
| 延長失敗 | プロンプトがソースと競合 | 延長プロンプトを元のシーンに合わせる |
前提条件
- 完了した、権利処理済みまたは合成のソースドラフト、承認済み延長概要、許可されたワークスペースとクレジット予算、ポリシーレビュー、ドラフト専用の出力先、およびロールバック/削除の責任者がいること。
手順
- 延長を作成する前に、ソースの所有権、完了状態、承認済みの継続概要を確認すること。プライベート、未ライセンス、またはポリシー制限のある素材は使用しないこと。
- 承認された期間とクレジット上限内で、ウォーターマーク付きのドラフトカナリーを1件提出し、その後ポリシー、権利、品質、出力先の制御を確認すること。
- 継続性、ポリシー、権利、または予算に逸脱が生じた場合は停止し、公開せずに延長タスクを削除すること。
- 所有者の承認を得た後にのみ公開すること。編集済みの領収書を保持し、合意された保持期間の終了時に一時的なアセットを削除すること。
出力
ソースタスク参照、権利分類、モード/期間、クレジット見積もり、ポリシーレビュー、ドラフト出力先、承認者、保持/削除参照、タスクIDを含む延長領収書を生成すること。プロンプト、ID、アセットURLは含めないこと。
例
source=synthetic-task-42; rights=cleared; duration=5s; mode=standard; policy=pass; destination=draft-only; cleanup=24h はレビューに安全です。