So nutzt du die Kling 4.0 API: Modi, Keyframes, Referenzen, Bearbeitung und Verlängerung

Um die Kling 4.0 API zu nutzen, erstellst du einen API-Schlüssel, sendest per POST einen JSON-Body mit der Modell-ID kling-4-0 und deinem Prompt und fragst die zurückgegebene Aufgabe ab, bis die Video-URL bereitsteht. Der gleiche Endpunkt deckt alle fünf Modi ab: Text zu Video, Bild zu Video mit bis zu 10 Frames, Referenzen aus Bildern, Videos und Audio, Videobearbeitung und Videoverlängerung. Die Medien, die du sendest, und ein Feld, omni_reference_task_type, entscheiden, welcher Modus läuft.

Diese Anleitung geht durch jeden Modus mit Request-Bodies, die am 22. Oktober 2026 ausgeführt wurden, zeigt dann, wie jeder Modus abgerechnet wird und welche Anfragen kostenlos abgelehnt werden.

Was brauchst du vor der ersten Anfrage?

1. Ein API-Schlüssel. Erstelle einen auf der Seite API-Schlüssel und halte ihn serverseitig. Gib ihn niemals in Browser-Code ein.
2. Guthaben. Füge ein Guthaben auf der Seite Abrechnung hinzu. Guthaben verfällt nie, und fehlgeschlagene Aufgaben werden nicht berechnet.
3. Die Modell-ID kling-4-0.

export SEEDROUTER_API_KEY="your-key"

Wie sendest du eine Kling 4.0 Anfrage?

Sende die Aufgabe per POST zu /v1/videos/generations:

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Die Antwort ist eine Aufgabe, kein Video:

{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}

Jedes Feld außer model und in den meisten Modi prompt hat einen Standard:

Es gibt keinen Tonschalter: jeder Kling 4.0 Clip hat eine Stereospur. Es gibt auch kein mode, negative_prompt oder watermark-Feld. Das Schema ist streng, daher wird ein unbekanntes Feld mit HTTP 400 abgelehnt, bevor eine Aufgabe erstellt wird, und ein Tippfehler wird niemals zu einem bezahlten Clip, dessen Einstellung stillschweigend ignoriert wird.

Wie bekommst du das Video?

Frage GET /v1/tasks/{id} alle 10–20 Sekunden ab, bis status completed oder failed ist. Unsere fünf Test-Läufe dauerten zwischen 2 Minuten 41 Sekunden und 4 Minuten 22 Sekunden für 3-Sekunden-720p-Clips, also plane für Minuten, nicht Sekunden.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

Eine fertige Aufgabe sieht so aus:

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

Dies ist der Clip, den die erste Anfrage auf dieser Seite erzeugt hat, 5 Sekunden bei 720p:

Kling 4.0, Text zu Video, 720p, 5 Sekunden, mit Stereoton.

Unsere 720p-Clips kamen als MP4 (H.264) bei 1280 × 720 mit Stereo-AAC-Spur zurück. Lade die Datei in deinen eigenen Speicher: Gehostete Links sind nicht dauerhaft. Ein Netzwerk-Timeout während der Abfrage bedeutet nicht, dass die Erzeugung fehlgeschlagen ist, daher behalte die Aufgaben-ID und prüfe sie erneut, statt eine neue Aufgabe einzureichen.

Welcher Modus läuft eine Kling 4.0 Anfrage?

Die Medien im Body wählen den Modus aus. omni_reference_task_type macht es explizit, wo die Medien allein mehrdeutig wären:

Frames und Referenzmedien können nicht in einer Anfrage gemischt werden, und ein video_url ohne edit oder extend wird abgelehnt. Beide kommen als HTTP 400 vor einer vorhandenen Aufgabe zurück.

Wie heftest du Keyframes in Kling 4.0 an?

Sende image_with_roles, eine Liste von {url, role}-Objekten. Genau ein first_frame, optional ein last_frame und bis zu 8 keyframe-Einträge, 10 Bilder insgesamt. Die Keyframes werden in der Reihenfolge verwendet, in der du sie auflistest, daher ist die Liste die Timeline.

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

Für nur einen Start und ein Ende ist image_urls: [first, last] kürzer. Bild zu Video ist der einzige Modus, in dem prompt weggelassen werden kann; der Clip übernimmt die Form des ersten Frames.

Wie nutzt du Bild-, Video- und Audio-Referenzen?

Füge video_urls (bis zu 5 Clips, 30 Sekunden insgesamt verwendet), audio_urls (bis zu 3 Clips von je 5–30 Sekunden) und Referenzbilder hinzu, höchstens 15 Dateien insgesamt. Erwähne sie im Prompt als @Image1, @Video1 und @Audio1, nummeriert ab 1 in jeder Liste:

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the deck of the sailboat from @Video1 at sunset",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/boat.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

Referenzbilder können auch in image_urls gehen, aber nur mit omni_reference_task_type: "reference"; ohne es werden image_urls als erster und letzter Frame gelesen. Ein Referenzvideo-Audio wird standardmäßig durch neues ersetzt; setze audio_setting: "origin", um es zu behalten.

Wie bearbeitest du ein Video mit Kling 4.0?

Setze omni_reference_task_type auf edit, gib das Video in video_url an und beschreibe die Änderung. Bis zu 10 Referenzbilder können in image_urls gehen.

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening with falling snow",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

Das Input muss mindestens 3 Sekunden lang sein und nur seine ersten 30 Sekunden werden verwendet. Lasse duration weg und das Ergebnis folgt der Länge des Eingabevideos; der ursprüngliche Ton wird bewahrt, es sei denn, du setzt audio_setting: "auto".

Wie verlängerst du ein Video?

Setze omni_reference_task_type auf extend, gib das Video an, und gib duration als die Länge des neuen Teils an. Kling 4.0 setzt vom letzten Frame fort und gibt die ursprüngliche plus die neuen Sekunden als eine Datei zurück. In unserem Test kam ein um 3 Sekunden verlängerter 5,2-Sekunden-Clip 8,1 Sekunden lang zurück.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

Füge last_frame_image hinzu, um zu wählen, wo der neue Teil endet. Verlängerung behält das Input-Verhältnis und den Ton, daher werden aspect_ratio und audio_setting abgelehnt.

Was kostet eine Kling 4.0 Anfrage?

Kling 4.0 wird pro Sekunde Video abgerechnet zu einem Tarif, der durch die Auflösung bestimmt wird. Die Sekunden, die zählen, hängen vom Modus ab:

Die Eingabe ist die Gesamtlänge der Eingabevideos, aufgerundet auf ganze Sekunden und auf 30 begrenzt. Sie wird gemessen, wenn die Anfrage akzeptiert wird, daher ist der reservierte Betrag auch der berechnete Betrag. In unserem Bearbeitungstest wurden eine 5,2-Sekunden-Eingabe und ein 3-Sekunden-Ergebnis mit 3 + 6 = 9 Sekunden abgerechnet. Dies sind die aktuellen Tarife:

Ein Video, dessen Länge nicht gelesen werden kann, wird kostenlos abgelehnt, und eine fehlgeschlagene Aufgabe wird nicht berechnet.

Welche Anfragen werden kostenlos abgelehnt?

Diese kommen als HTTP 400 bei Einreichung zurück, ohne dass eine Aufgabe erstellt oder etwas berechnet wird:

Eine Aufgabe, die akzeptiert und dann fehlschlägt, z. B. bei der Inhaltsrichtlinie des Modells, gibt status: "failed" mit einem error-Code zurück und wird nicht berechnet. Der Fehlerkatalog listet die Codes auf.

Kann ein Coding Agent es für dich ausführen?

Ja. Die Seite Kling 4.0 hat einen fertigen Prompt für Claude Code, Codex oder Cursor, der den Schlüssel aus deiner Umgebung liest, dir die Anfrage und ihre Kosten zeigt, auf deine Genehmigung wartet und dann einreicht, abfragt und den Clip herunterlädt. Die gleiche Seite hat einen Playground, der den genauen Body sendet, den dein Code würde, mit jedem Feld nach Modus gruppiert.

Kling 4.0 API Fragen

Ist die Kling 4.0 API kostenlos?

Nein. Sie wird pro Sekunde Video abgerechnet. Neue SeedRouter-Konten erhalten ein kleines Guthaben zum Testen, es gibt kein Abo, und fehlgeschlagene Aufgaben werden nicht berechnet.

Ist Kling 4.0 Flash in der API?

Noch nicht. Kling 4.0 Flash ist ein separates, leichteres Modell in der gleichen Familie; Kling listet es mit kürzeren 720p-Clips und ohne mehrere Keyframes auf.^[1] Die kling-4-0 Modell-ID ist das vollständige Kling 4.0.

Wie unterscheidet sich Kling 4.0 von Kling 3.0 in der API?

Kling 4.0 macht Clips bis 30 Sekunden, nimmt Keyframes, Video- und Audio-Referenzen und kann ein Video bearbeiten oder verlängern; Ton ist immer an. Kling 3.0 macht 3–15 Sekunden lange Clips, bietet 4K, Multi-Shot-Prompts und benannte Elemente und hat einen Tonschalter. Die Kling 3.0 API Anleitung behandelt ihre Felder. Kling kündigte 4.0 mit seiner 30-Sekunden-Länge, 10 Keyframes und Stereoton am 30. September 2026 an.^[2]

Kann ich eine Aufgabe abbrechen?

Nein. Sobald angenommen, läuft eine Aufgabe bis zur Fertigstellung oder zum Fehlschlag. Fehlgeschlagene Aufgaben werden nicht berechnet.

Referenzen

1. Kling AI. Kling 4.0 Videogenerierung (Funktionsübersicht und FAQ). Überprüft am 8. Oktober 2026 auf kling.ai.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. 30. September 2026. Überprüft am 8. Oktober 2026 auf kling.ai.