Was macht Kling AI Videoerweiterung?
Übersicht
Erweitere ein vorhandenes Video, indem zusätzliche Sekunden angehängt werden. Der Verlängerungsendpunkt verwendet die task_id eines abgeschlossenen Videos und erzeugt eine nahtlose Fortsetzung.
Endpunkt: POST https://api.klingai.com/v1/videos/video-extend
Anfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
task_id | string | Ja | Task-ID des abgeschlossenen Quellvideos |
prompt | string | Nein | Bewegungs-/Szenenbeschreibung für die Verlängerung |
duration | string | Nein | Verlängerungslänge: "5" (Standard) |
mode | string | Nein | "standard" oder "professional" |
model_name | string | Nein | Standard: "kling-v2-master" |
callback_url | string | Nein | Webhook für Fertigstellung |
Basisverlängerung
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"}
# Schritt 1: Initiales 5s-Video generieren
initial = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Eine Rakete startet aus einer Wüstenlandschaft, filmisch",
"duration": "5",
"mode": "standard",
}).json()
initial_task_id = initial["data"]["task_id"]
# Warte auf Fertigstellung...
# (poll bis task_status == "succeed")
# Schritt 2: Um weitere 5 Sekunden verlängern
extension = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": initial_task_id,
"prompt": „Die Rakete steigt durch Wolken in die Stratosphäre auf",
"duration": "5",
"mode": "standard",
}).json()
ext_task_id = extension["data"]["task_id"]
# Schritt 3: Verlängerungsaufgabe abfragen
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"Verlängertes Video: {extended_url}")
break
elif result["data"]["task_status"] == "failed":
print(f"Fehlgeschlagen: {result['data']['task_status_msg']}")
break
Mehrere Verlängerungen verketten
def chain_extensions(initial_task_id: str, prompts: list[str],
duration: str = "5", mode: str = "standard") -> list[str]:
"""Kette mehrere Verlängerungen, um ein längeres Video zu erstellen."""
current_task_id = initial_task_id
video_urls = []
for i, prompt in enumerate(prompts):
print(f"Verlängerung {i + 1}/{len(prompts)}: einreichen...")
# Verlängerung einreichen
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"]
# Auf Fertigstellung warten
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 # nächste Verlängerung wird an diese angehängt
print(f"Verlängerung {i + 1} abgeschlossen: {url}")
break
elif status == "failed":
raise RuntimeError(f"Verlängerung {i + 1} fehlgeschlagen: {result['data']['task_status_msg']}")
return video_urls
Verwendung: Ein 20-Sekunden-Video erstellen
# Initiales 5s-Video generieren
initial_r = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Morgendämmerung über einem Bergsee, Nebel steigt auf",
"duration": "5",
"mode": "standard",
}).json()
initial_id = initial_r["data"]["task_id"]
# ... warten, bis abgeschlossen ...
# 3 weitere Verlängerungen anhängen = 5 + 5 + 5 + 5 = 20 Sekunden gesamt
extensions = chain_extensions(initial_id, [
„Die Sonne steigt höher, Vögel beginnen über den See zu fliegen",
„Ein Hirsch nähert sich dem Ufer, um zu trinken",
„Weite Einstellung, die die gesamte Bergkette enthüllt",
])
Kosten
Jede Verlängerung kostet genauso viel wie eine neue Generierung:
| Verlängerungslänge | Standard | Professional |
|---|---|---|
| 5 Sekunden | 10 Credits | 35 Credits |
Ein 20-Sekunden-Video (initial + 3 Verlängerungen) kostet 40 Credits im Standard-Modus.
Fehlerbehandlung
| Fehler | Ursache | Lösung |
|---|---|---|
Ungültige task_id | Quellaufgabe existiert nicht | Überprüfen, ob task_id von einer abgeschlossenen Generierung stammt |
| Quelle nicht abgeschlossen | Verlängerung einer noch verarbeiteten Aufgabe | Warten, bis die Quellaufgabe den Status succeed erreicht hat |
| Verlängerung fehlgeschlagen | Prompt-Konflikt mit Quelle | Verlängerungsprompt an ursprüngliche Szene anpassen |
Voraussetzungen
- Ein abgeschlossener, rechtegeklärter oder synthetischer Quellentwurf, eine genehmigte Verlängerungsabstimmung, ein autorisierter Arbeitsbereich und ein Kreditbudget, eine Richtlinienüberprüfung, ein reines Entwurfsziel und ein Rücknahme-/Entfernungseigentümer.
Anweisungen
- Bestätige vor der Erstellung einer Verlängerung die Quellbesitzverhältnisse, den Fertigstellungsstatus und die genehmigte Kontinuitätsabstimmung; verwende kein privates, nicht lizenziertes oder richtlinieneingeschränktes Material.
- Reiche einen wasserzeichengeschützten Entwurfscanari innerhalb der genehmigten Dauer und des Kreditlimits ein, und überprüfe dann Richtlinien, Rechte, Qualität und Zielkontrollen.
- Stoppe bei Kontinuitäts-, Richtlinien-, Rechte- oder Budgetabweichungen und lösche die Verlängerungsaufgabe anstatt sie zu veröffentlichen.
- Gib sie nur nach Genehmigung des Eigentümers frei; bewahre einen geschwärzten Beleg auf und entferne temporäre Vermögenswerte an der vereinbarten Aufbewahrungsgrenze.
Ausgabe
Erstelle einen Verlängerungsbeleg mit Quellaufgaben-Referenz, Rechteklassifizierung, Modus/Dauer, Kreditschätzung, Richtlinienprüfung, Zielentwurf, Genehmigendem, Aufbewahrungs-/Entfernungsverweis und Aufgaben-ID. Schließe Prompts, Identitäten und Asset-URLs aus.
Beispiele
source=synthetic-task-42; rights=cleared; duration=5s; mode=standard; policy=pass; destination=draft-only; cleanup=24h ist sicher für die Überprüfung.