Wie verwende ich die Kling 2.5 Turbo API? In 5 Minuten zum ersten Video

TL;DR

• Kling 2.5 Turbo ist das schnelle Videomodell von Kuaishou Kling. Bei HiAPI gibt es zwei Einstiege: Text-zu-Video und Bild-zu-Video. Öffne die Modellseite und teste es direkt online – neue Nutzer erhalten bei der Registrierung 200 Credits.
• Beide Einstiege kosten $0,06 pro Sekunde: 5 Sekunden $0,30, 10 Sekunden $0,60.
• Aufruf: Mit POST /v1/tasks absenden, mit taskId das Ergebnis abfragen, das fertige Video liegt unter output[0].url.

Was Kling 2.5 Turbo kann

• 5 oder 10 Sekunden, ca. 1080p: Die Auflösung richtet sich nach dem Seitenverhältnis; bei 16:9 wird 1920×1080 ausgegeben, ohne separate Einstellung.
• Text-zu-Video mit Ton: Jedes Video hat eine Tonspur, ohne Schalter.
• Bild-zu-Video mit Endframe: Der Startframe legt den Anfang, der Endframe das Ende fest, das Modell ergänzt den Zwischenverlauf.
• Bild-zu-Video mit 6 Seitenverhältnissen: Neben Quer-, Hoch- und Quadratformat auch 4:3, 3:4 und 21:9 Breitbild.

Vertical cinematic shot of a ceramic artist in a sunlit studio. Her hands shape a small terracotta bowl on a spinning pottery wheel. The wet clay gradually rises as the wheel turns, a little water glints on the surface. The camera gently tracks upward from the bowl to her focused face. Warm morning light, linen apron, natural movement, one continuous shot, no text or logos.

Mit diesem Prompt generieren → (10 Sekunden, 9:16 wählen)

kling-2.5-turbo/text-to-video, 9:16, 1080×1920, 10 Sekunden, mit Tonspur, $0,60.

Wie du zwischen den beiden Einstiegen wählst

Modell-ID	Eingabe	Seitenverhältnis	Ton	Geeignet für
kling-2.5-turbo/text-to-video	Prompt	16:9, 9:16, 1:1	Mit Tonspur	Kein Ausgangsmaterial, Start mit Text
kling-2.5-turbo/image-to-video	Startframe erforderlich, Endframe optional	6 Varianten; mit Endframe 3	Keine Tonspur	Produktbilder, Fotografie, Illustrationen in Bewegung bringen

Beide Einstiege kosten gleich viel, jeweils $0,06 pro Sekunde.

Zwei Wege zum Einstieg

Im Browser testen (3 Schritte)

1. Öffne die Modellseite für Text-zu-Video oder Bild-zu-Video und melde dich an.
2. Prompt schreiben; bei Bild-zu-Video zuerst den Startframe hochladen, bei Bedarf dann den Endframe.
3. 5 Sekunden und Seitenverhältnis wählen, dann auf Ausführen klicken.

Über die API aufrufen (3 Schritte)

1. Erstelle im API-Key-Bereich der Konsole einen Schlüssel und lege ihn in die Umgebungsvariable HIAPI_KEY.
2. POST https://api.hiapi.ai/v1/tasks absenden, Rückgabe ist data.taskId.
3. Mit GET /v1/tasks/{taskId} prüfen, bis status success ist, dann output[0].url herunterladen.

curl: das erste Video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.5-turbo/text-to-video",
    "input": {
      "prompt": "Hands pour glossy caramel over a stack of pancakes, steam rises, camera slowly pushes in, warm kitchen light",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 Sekunden, 16:9, $0,30. Bei Bild-zu-Video model durch kling-2.5-turbo/image-to-video ersetzen und "image_urls": ["https://dein-bildhost/frame.jpg"] hinzufügen.

Python: absenden, abfragen, herunterladen

# pip install requests; zuerst export HIAPI_KEY=dein Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # Beim Wiederholen derselben Aufgabe denselben Idempotency-Key mitschicken, um doppelte Abbuchungen zu vermeiden
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Startframe + Endframe: Ein rotes Auto fährt von links nach rechts und wird blau (5 Sekunden, $0,30)
url = generate(
    "kling-2.5-turbo/image-to-video",
    prompt="A toy car moves smoothly from the left to the right and changes from red to blue. "
           "Keep the simple light grey background and beige ground. Continuous static camera shot.",
    image_urls=["https://dein-bildhost/first.png", "https://dein-bildhost/last.png"],
    duration=5, aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Startframe plus Endframe: den Clip dort stoppen lassen, wo du willst

Übergib zwei Bilder in image_urls: Das erste ist der Startframe, das zweite der Endframe. Beim folgenden Beispiel ist der Startframe das rote Auto links, der Endframe das blaue Auto rechts:

Startframe	Endframe

A toy car moves smoothly from the left to the right and changes from red to blue. Keep the simple light grey background and beige ground. Continuous static camera shot.

Mit diesem Prompt generieren → (Startframe und Endframe hochladen, 5 Sekunden, 9:16 wählen)

kling-2.5-turbo/image-to-video, 9:16, 1080×1920, 5 Sekunden, Startframe + Endframe, $0,30.

Das Auto fährt nach rechts, wechselt unterwegs die Farbe von Rot über Violett zu Blau und bleibt am Ende an der Position des Endframes stehen, der Hintergrund bleibt durchgehend gleich. Am stabilsten wird das Ergebnis, wenn beide Bilder bis auf das zu ändernde Element identisch sind. Mit Endframe sind nur die Seitenverhältnisse 16:9, 9:16 oder 1:1 wählbar.

Parametertabelle

Feld	Erforderlich	Werte	Beschreibung
prompt	Ja	1–2500 Zeichen	Aktion und Kameraführung beschreiben; bei Bild-zu-Video das Bild nicht erneut beschreiben
duration	Nein	5 (Standard) / 10	Abrechnung pro Sekunde
aspect_ratio	Nein	Text-zu-Video: 16:9 (Standard) 9:16 1:1; Bild-zu-Video zusätzlich 4:3 3:4 21:9	Mit Endframe nur 16:9 9:16 1:1
image_urls	Bei Bild-zu-Video erforderlich	1–2 Bilder, jpeg/png/webp, je ≤10MB	1. Bild Startframe, 2. Bild Endframe; Text-zu-Video akzeptiert dieses Feld nicht
negative_prompt	Nein	Text-zu-Video ≤2500, Bild-zu-Video ≤2496 Zeichen	Inhalte, die nicht erscheinen sollen
cfg_scale	Nein	0–1, Standard 0,5	Je höher, desto stärker folgt es dem Prompt

Es gibt kein resolution, seed und keinen Ton-Schalter.

Fehler, die dir begegnen werden

Bei falschen Parametern beim Absenden gibt die Schnittstelle direkt 400 zurück, es wird keine Aufgabe erstellt und nichts abgebucht:

• duration: value must be one of 5, 10: Die Dauer kann nur 5 oder 10 sein.
• aspect_ratio: value must be one of '16:9', '9:16', '1:1': Bei Text-zu-Video wurde ein anderes Seitenverhältnis übergeben, oder bei Bild-zu-Video mit Endframe wurde 4:3, 3:4 oder 21:9 gewählt.
• image_urls: maxItems: got 3, want 2: Maximal zwei Bilder, Startframe plus Endframe.
• image_urls: missing required field "image_urls": Bei Bild-zu-Video wurde kein Startframe übergeben.
• cfg_scale: maximum: got 5, want 1: cfg_scale liegt zwischen 0 und 1, nicht wie bei anderen Modellen üblich zwischen 1 und 20.
• additional properties 'seed', 'sound' not allowed: Diese beiden Felder existieren nicht.

Vor dem Go-live beachten

• Callbacks statt Polling verwenden: Auf oberster Ebene der Anfrage (gleichrangig mit input) "callback": {"url": "https://deine-domain/hiapi/callback"} hinzufügen und nach taskId deduplizieren.
• Rechtzeitig sichern: output[0].url verfällt nach etwa 7 Tagen, speichere das Video sofort in deinem eigenen Speicher.
• duration und aspect_ratio explizit angeben: Ohne Angabe gilt 5 Sekunden und 16:9, bei Hochformat-Anforderungen wird das leicht übersehen.
• Bei Wiederholungen Idempotenz-Key mitschicken: Idempotency-Key im Request-Header hinzufügen, derselbe Key erstellt nur eine Aufgabe.

Häufige Fragen

Kann man bei Text-zu-Video den Ton ausschalten?

Nein, es gibt keinen Ton-Schalter. Wenn du keinen Ton willst, entferne die Tonspur beim Schnitt, oder verwende Bild-zu-Video, das hat von Haus aus keine Tonspur.

Was passiert, wenn das Seitenverhältnis des Startframes nicht dem gewählten Seitenverhältnis entspricht?

Der Startframe wird mittig auf das gewählte Seitenverhältnis zugeschnitten. Wählst du bei einem 16:9-Bild 9:16, bleibt ein mittlerer vertikaler Streifen erhalten; das Motiv am besten in die Mitte setzen.

Geht 4K?

Nein. Die Ausgabe liegt bei etwa 1080p, je nach Seitenverhältnis; das breiteste ist 21:9 mit 2200×940.

Wie wähle ich zwischen Kling 2.5 Turbo und Kling 3.0 Turbo?

Wenn 5 oder 10 Sekunden ausreichen und du den niedrigsten Preis willst, nimm Kling 2.5 Turbo; wenn du 3–15 Sekunden sekundengenau wählen oder zwischen 720p und 1080p entscheiden willst, siehe Vergleich Kling 2.5 Turbo und 3.0 Turbo.

Preisdetails findest du unter Kling 2.5 Turbo API-Preise, weitere Szenarien unter Kling 2.5 Turbo Prompt-Sammlung. Wenn du zuerst das Ergebnis sehen willst, kopiere den obigen Töpfer-Prompt und generiere dein erstes Video auf der Modellseite.