Kuaishou

Kling 2.5

kling-2.5-turbo/text-to-video

Ein von Kuaishou vorgestelltes Bild-zu-Video-Modell mit herausragender Bewegungsflüssigkeit und Charakterkonsistenz, das negative Prompts und CFG-Anpassung unterstützt und sich für die Erzeugung von Kurzfilmen mit hochdynamischen Kameraeinstellungen eignet

kling-2.5-turbo/image-to-video kling-2.5-turbo/text-to-video

kling-2.5-turbo/text-to-video ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

video

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

kling-2.5-turbo/text-to-video per second

Einzelpreis	$0.060

Positionsprofil

Die Text-zu-Video-Variante von Kling 2.5 Turbo richtet sich an Entwickler, die kurze Videos direkt aus Text erzeugen müssen. Ein Prompt genügt, um cineastische Clips von bis zu 10 Sekunden Länge zu erzeugen, wahlweise im Querformat, Hochformat oder quadratischen Format, mit Unterstützung für Negativ-Prompts und CFG-Anpassung zur Steuerung der Bildentwicklung. Geeignet für Werbespots, Film-Vorschauen und schnelle Content-Produktion für soziale Medien, mit guter Leistung bei Szenen mit hoher Dynamik und Kamerabewegung.

Kernhighlights

Quantifizierbar anpassbare Prompt-Treue – cfg_scale regelt zwischen 0 und 1, wie stark das Video der Textbeschreibung folgt, um ein Gleichgewicht zwischen kreativer Freiheit und präziser Umsetzung zu finden.
Negativ-Prompts schließen störende Elemente aus – unterstützt negative_prompt mit bis zu 2500 Zeichen, um unerwünschte Inhalte explizit zu beschreiben und Ausschuss-Neugenerierungen zu reduzieren.
Drei Formate für verschiedene Veröffentlichungskanäle – aspect_ratio bietet 16:9, 9:16 und 1:1, sodass eine Integration Querformat, Hochformat und quadratische Inhalte abdeckt.
Zwei Längenoptionen: 5 und 10 Sekunden – duration wahlweise 5 oder 10 Sekunden, um die Cliplänge je nach Bedarf zu steuern, geeignet für Kurzfilme und Storyboard-Material.

Funktionsbeschreibung

Direkte Videoerzeugung aus Text: Ein Prompt, der Motiv, Aktion, Szene und Kamerabewegung beschreibt, genügt zur Videoerzeugung, bis zu 2500 Zeichen, ideal für die Batch-Produktion von Kameramaterial in natürlicher Sprache.

Negativ-Prompts und CFG-Steuerung: Über negative_prompt unerwünschte Elemente ausschließen und mit cfg_scale die Stärke der Prompt-Treue anpassen, um wiederholtes Ausprobieren zu reduzieren und die Verwertbarkeit beim ersten Durchlauf zu erhöhen.

Wählbares Format und wählbare Dauer: Je nach Veröffentlichungskanal 16:9, 9:16 oder 1:1 wählen und 5 oder 10 Sekunden Dauer angeben, sodass die Ausgabe direkt den Spezifikationen der Kanäle entspricht.

Anwendungsszenarien

Werbe- und Markenteams: Produkttexte in Kurzfilme umwandeln – Produktbeschreibung und Kamerabewegungs-Prompts eingeben und 5- oder 10-sekündiges Markenfilmmaterial für Feed-Werbung und Social-Media-Veröffentlichung erzeugen.
Film-Preproduction-Teams: Vorschau von Drehbuchausschnitten – Szenenbeschreibungen in dynamische Konzeptclips umwandeln, die als Storyboard und visuelle Vorschau dienen und Regie sowie Kamera bei der Bestätigung des Bildrhythmus unterstützen.
Social-Media-Management: Batch-Produktion von Hochformat-Kurzclips – 9:16-Format und kurze Dauer wählen und anhand von Themen-Prompts Hochformat-Material in Serie erzeugen für die tägliche Content-Aktualisierung auf Kurzvideo-Plattformen.
Ersteller von Action- und Sportinhalten: Erzeugung hochdynamischer Aufnahmen – Mit Prompts Bewegungen, Tanz und andere komplexe Aktionen beschreiben und flüssig wirkende Clips für Sport- oder Tanzinhalte erzeugen.

Einschränkungen und Auswahlhinweise

Die maximale Dauer einer einzelnen Generierung beträgt 10 Sekunden und eignet sich nicht für die direkte Erzeugung langer Videos; Nachbearbeitung durch Zusammensetzen oder segmentierte Generierung ist erforderlich. Die Qualität des Ergebnisses hängt stark von der Prompt-Formulierung sowie der Abstimmung von cfg_scale und Negativ-Prompts ab; bei der ersten Nutzung empfiehlt es sich, zunächst in kleinen Stichproben zu testen und die Parameter zu ermitteln. Diese Variante akzeptiert ausschließlich Texteingaben; wer bereits Referenzbilder besitzt und die Bildkonsistenz wahren möchte, sollte die Bild-zu-Video-Variante derselben Familie wählen. Bei Projekten mit Langzeit-Erzählung oder strenger Storyboard-Kontinuität müssen die Übergangskosten nach segmentierter Generierung bewertet werden.

Neuigkeiten

Changelog ansehen →

Neues Modell Dokumentation für kling-2.5-turbo/text-to-video hinzugefügt Oct 10, 2026
Neues Modell Neue Videomodell-Dokumentation: kling-2.5-turbo/image-to-video (erstes Frame als Eingabe, feste 5 Sekunden in 1080p, optional… Oct 8, 2026

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: kling-2.5-turbo/text-to-video

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für kling-2.5-turbo/text-to-video und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 2500

Prompt zur Beschreibung von Motiv, Aktion, Szene und Kamerabewegung des Videos, anhand dessen das Modell den entsprechenden Bildinhalt generiert.

durationintegerOptionalStandard: 5min 5max 10

Dauer des generierten Videos in Sekunden; Standard 5 Sekunden.

Optionen:510

cfg_scalenumberOptionalStandard: 0.5min 0max 1

Stärke der Prompt-Befolgung, steuert, wie eng sich das Videobild an die Textbeschreibung hält; Standard 0.5.

aspect_ratiostringOptionalStandard: "16:9"

Seitenverhältnis, bestimmt das Querformat, Hochformat oder quadratische Bild und kann je nach Veröffentlichungsort gewählt werden; Standard 16:9.

Optionen:16:99:161:1

negative_promptstringOptionalmaxLength 2500

Negativ-Prompt zur Beschreibung von Inhalten, die im generierten Video nicht erscheinen sollen; das Modell vermeidet diese Elemente so weit wie möglich.

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "cfg_scale": 0.5,
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "kling-2.5-turbo/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "cfg_scale": 0.5,
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "kling-2.5-turbo/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "cfg_scale": 0.5,
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}