Wie verwende ich die Kling 3.0 Turbo Text-zu-Video-API? Parameter, Code und Fehler

TL;DR

• Der Modellname von Kling 3.0 Turbo Text-zu-Video ist kling-3.0-turbo/text-to-video, die schnelle Stufe von Kling 3.0. Modellseite öffnen und direkt online testen.
• Abrechnung pro Sekunde: 720p $0.13 pro Sekunde, 1080p $0.16 pro Sekunde. Die Dauer ist eine beliebige ganze Zahl von 3–15 Sekunden; 5 Sekunden in 720p kosten $0.65 pro Video.
• Es gibt nur 4 Parameter: prompt, duration, aspect_ratio, resolution. Jedes zusätzlich übergebene Feld (z. B. seed, negative_prompt) führt zu einem 400.

Erst mal ein Beispiel

720p, 5 Sekunden, 16:9:

aerial drone shot sweeping over a norwegian fjord waterfall, mist drifting,
camera gliding forward, smooth natural motion, stable cinematic camera
movement, consistent lighting across frames, cinematic composition, dramatic
directional lighting, rich cohesive color grade, ultra-detailed, premium
commercial finish

Mit diesem Prompt generieren → (5 Sekunden, 720p, 16:9)

kling-3.0-turbo/text-to-video, 5 Sekunden.

Parameter auf einen Blick

Feld	Pflicht	Werte	Beschreibung
prompt	Ja	max. 2500 Zeichen	Bild, Motiv, Aktion, Kameraführung; Dialog in Anführungszeichen kann lippensynchron umgesetzt werden
duration	Nein	Ganzzahl 3–15, Standard 5	Abrechnung pro Sekunde, jede Sekunde mehr kostet mehr
aspect_ratio	Nein	16:9 (Standard) / 9:16 / 1:1	Querformat, Hochformat, quadratisch
resolution	Nein	720p (Standard) / 1080p	Bestimmt den Stückpreis pro Sekunde

Es gibt kein sound-Feld, aber das fertige Video enthält standardmäßig Ton, der sich nicht abschalten lässt. Auch kein 4K, kein Endbild, kein Referenzbild – wer das braucht, verwendet die Standardversion von Kling 3.0 oder Omni.

curl: das erste Video zum Laufen bringen

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo/text-to-video",
    "input": {
      "prompt": "A golden retriever surfing a turquoise wave at sunset, cinematic slow motion, water droplets frozen mid-air",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p"
    }
  }'

Die Antwort enthält nur data.taskId. Alle 5–10 Sekunden GET /v1/tasks/{taskId} abfragen und das Video von output[0].url herunterladen, sobald status zu success wird.

Python: Senden, Abfragen, Herunterladen

# pip install requests; 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(timeout_s=900, **inp):
    # Beim erneuten Versuch derselben Übermittlung denselben Idempotency-Key wiederverwenden, dann wird nur einmal abgerechnet
    r = requests.post(API, json={"model": "kling-3.0-turbo/text-to-video", "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"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(8)
    raise TimeoutError(task_id)

# Hochformat, 3 Sekunden, 720p zum Ausprobieren der Richtung, $0.39
url = generate(
    prompt="A barista pours latte art in slow motion, close-up, warm cafe light",
    duration=3, aspect_ratio="9:16", resolution="720p",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Was kostet es

Dauer	720p ($0.13/Sek.)	1080p ($0.16/Sek.)
3 Sekunden (kürzeste)	$0.39	$0.48
5 Sekunden	$0.65	$0.80
10 Sekunden	$1.30	$1.60
15 Sekunden (längste)	$1.95	$2.40

Aktueller HiAPI-Preis, geprüft am 18. Oktober 2026.

Bei Fehlschlag wird nichts berechnet. Der vollständige Vergleich steht unter Kling 3.0 Turbo API-Preise.

Fehler, die dir begegnen werden

Was du übergeben hast	Antwort
prompt nicht übergeben	400, missing required field "prompt"
Zusätzliche Felder übergeben (z. B. seed, negative_prompt)	400, additional properties ... not allowed
duration: 2	400, duration: minimum: got 2, want 3
duration: 99	400, duration: maximum: got 99, want 15
aspect_ratio: "4:3"	400, nur 16:9, 9:16, 1:1 erlaubt
resolution: "480p"	400, nur 720p, 1080p erlaubt
Key falsch oder fehlend	401, permission_denied
Guthaben unzureichend	402, zuerst aufladen, dann erneut prüfen

Parameterfehler werden beim Senden synchron zurückgegeben; bei einer fehlgeschlagenen Generierung wird später beim Abfragen status zu fail und der Fehler steht in data.error. Beide Wege müssen behandelt werden.

Hinweise vor dem Livegang

• Callbacks statt Polling verwenden: Auf derselben Ebene wie input "callback": {"url": "https://your-app.example.com/hiapi/callback", "when": "final"} hinzufügen; der Task meldet sich am Ende nur einmal, per taskId deduplizieren.
• Den Idempotency-Key-Header mitsenden: Bei Timeout-Wiederholungen denselben Key verwenden, dann wird nur ein Task erstellt und nur einmal abgerechnet.
• Ergebnis sofort herunterladen: output[0].url hat eine begrenzte Gültigkeit.
• Über 15 Sekunden aufteilen: Das letzte Bild des vorherigen Clips als erstes Bild an kling-3.0-turbo/image-to-video übergeben und weiter generieren.

Häufige Fragen

Wie lange dauert ein Video?

Es dauert Minuten; je länger die Dauer und je höher die Auflösung, desto länger. Als Obergrenze für das Polling sind 10–15 Minuten empfehlenswert, oder direkt Callbacks verwenden.

Werden negative Prompts unterstützt?

Nein. Was vermieden werden soll, direkt in den Prompt schreiben, z. B. „no text overlays, no watermarks“.

Wie wählt man zwischen Turbo und der Kling 3.0 Standardversion?

Turbo ist die Speed-Stufe und enthält standardmäßig Ton; die Standardversion ohne Ton ist mit $0.10 pro Sekunde in 720p günstiger, Ton lässt sich ein- oder ausschalten und 4K ist möglich. Ein Vergleich mit demselben Prompt steht unter Kling 3.0 Turbo vs. Kling 3.0.

Den Fjord-Prompt oben kopieren und für $0.39 ein 3-Sekunden-Testvideo generieren.