Kling AI Text-zu-Video
Übersicht
Erstellen Sie Videos aus Textvorgaben mit dem Endpunkt /v1/videos/text2video. Unterstützt die Modelle v1 bis v2.6, Standard-/Professional-Modi, Kamera-Steuerung, Negative Prompts und nativen Audio-Support (v2.6+).
Endpunkt: POST https://api.klingai.com/v1/videos/text2video
Anfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
model_name | string | Ja | Modellversion (siehe Modellkatalog) |
prompt | string | Ja | Videobeschreibung, maximal 2500 Zeichen |
negative_prompt | string | Nein | Was von der Generierung ausgeschlossen werden soll |
duration | string | Ja | "5" oder "10" Sekunden |
aspect_ratio | string | Nein | "16:9" (Standard), "9:16", "1:1", usw. |
mode | string | Nein | "standard" (Standard) oder "professional" |
cfg_scale | float | Nein | Prompt-Treue (0.0-1.0, Standard 0.5) |
camera_control | object | Nein | Kamera-Bewegungskonfiguration |
callback_url | string | Nein | Webhook-URL für Benachrichtigung bei Fertigstellung |
Vollständiges Beispiel – 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"}
# Text-zu-Video-Aufgabe erstellen
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Luftaufnahme mit Drohne eines Korallenriffs zur goldenen Stunde, "
"tropische Fische schwimmen durch kristallklares Wasser, "
"Sonnenstrahlen dringen durch die Oberfläche, filmreifes 4K",
"negative_prompt": "verschwommen, minderwertige Qualität, verzerrt, Wasserzeichen",
"duration": "5",
"aspect_ratio": "16:9",
"mode": "professional",
"cfg_scale": 0.5,
})
task = response.json()
task_id = task["data"]["task_id"]
# Auf Fertigstellung warten
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"Video-URL: {video['url']}")
print(f"Dauer: {video['duration']}s")
break
elif status == "failed":
raise RuntimeError(result["data"]["task_status_msg"])
# else: submitted/processing — weiter abfragen
Mit Kamera-Steuerung
# Kamera-Bewegungstypen: schwenken, neigen, zoomen, rollen
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Eine mittelalterliche Burg auf einer Klippe bei Sonnenaufgang, Nebel im Tal",
"duration": "5",
"mode": "standard",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 5, # nach rechts schwenken (negativ = links), Bereich -10 bis 10
"vertical": 0, # neigen (negativ = nach unten, positiv = nach oben)
"zoom": 3, # hineinzoomen (positiv) oder herauszoomen (negativ)
"roll": 0, # Drehung
"pan": 0, # Dolly links/rechts
"tilt": -2, # Dolly auf/ab
}
},
})
Regel: Nur ein Nicht-Null-Feld in config für type: "simple".
Mit nativem Audio (nur v2.6)
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Eine Jazzband, die in einem schwach beleuchteten Club spielt, Saxophon-Solo, "
"das Publikum klatscht, warmes bernsteinfarbenes Licht",
"duration": "10",
"mode": "professional",
"motion_has_audio": True, # erzeugt synchronisiertes Audio
})
Tipps zum Prompt-Engineering
| Technik | Beispiel |
|---|---|
| Szene + Aktion + Stil | "Ein Samurai, der durch Kirschblüten geht, filmreife Zeitlupe" |
| Lichtstimmung | "goldene Stunde", "neonbeleuchtet", "bedeckt diffuses Licht" |
| Kamerasprache | "Nahaufnahme", "weite Einstellung", "Kamerafahrt" |
| Negative Prompt | "verschwommen, Wasserzeichen, Textüberlagerung, verzerrte Gesichter" |
| Material/Textur | "gebürsteter Stahl", "handgemaltes Aquarell", "fotorealistisch" |
Kostenreferenz
| Dauer | Standard | Professional |
|---|---|---|
| 5 Sekunden | 10 Credits | 35 Credits |
| 10 Sekunden | 20 Credits | 70 Credits |
Fehlerbehandlung
| Fehler | Ursache | Behebung |
|---|---|---|
400 ungültiger Prompt | Leer oder >2500 Zeichen | Prompt-Länge prüfen |
400 ungültiges Modell | Nicht unterstützter model_name | Gültige Modell-ID aus Katalog verwenden |
402 nicht genügend Credits | Nicht genug Credits | Konto aufladen |
task_status: failed | Verstoß gegen Inhaltsrichtlinien oder zu komplex | Prompt vereinfachen, eingeschränkte Inhalte entfernen |
Voraussetzungen
- Ein genehmigtes Briefing, rechtsfreies oder synthetisches Referenzmaterial, ein autorisierter Arbeitsbereich und ein Budget, eine Überprüfung der Inhaltsrichtlinien sowie ein benannter Eigentümer für Veröffentlichung und Löschung.
Anweisungen
- Erstellen Sie einen Sandbox-Entwurf aus einem genehmigten Briefing; fügen Sie keine privaten Personen, geschütztes Material oder unbelegte Behauptungen in Prompts oder Uploads ein.
- Überprüfen Sie die angeforderte Dauer, den Stil, das Ziel, das Kreditbudget, den Status der Inhaltsrichtlinie und die Einstellung "Nur Entwurf" vor der Einreichung.
- Überprüfen Sie einen mit Wasserzeichen versehenen Canary-Render auf Richtlinien, Rechte und Qualität; stoppen Sie bei einem Richtlinien- oder Urheberrechtsbedenken und löschen Sie den Entwurf, anstatt ihn zu veröffentlichen.
- Veröffentlichen Sie nur nach Genehmigung durch den Eigentümer und bewahren Sie einen geschwärzten Produktionsbeleg auf; entfernen Sie temporäre Assets zum genehmigten Aufbewahrungszeitpunkt.
Ausgabe
Erstellen Sie einen Render-Beleg mit Briefing-ID, genehmigter Quellenklassifizierung, Modell/Modus, Dauer, Kreditschätzung, Ergebnis der Richtlinien- und Rechteprüfung, Entwurfsziel, Genehmiger, Aufbewahrungs-/Löschungsreferenz und Aufgaben-ID. Schließen Sie Prompt-Text, Identitäten und Anmeldeinformationen aus.
Beispiele
brief=synthetic-product-demo; source=rights-cleared; mode=standard; duration=5s; policy=pass; destination=draft-only; approval=pending; cleanup=24h ist eine sichere Canary-Anfrage.