Lightricks

LTX 2.5 Fast

ltx-2.5-fast/text-to-video

Beschleunigtes Videogenerierungsmodell von Lightricks, unterstützt Text-zu-Video und Bild-zu-Video, erzeugt Bild und Audio synchron – ideal für schnelle Produktionen und die Validierung von Prototypen

ltx-2.5-fast/image-to-video ltx-2.5-fast/text-to-video

ltx-2.5-fast/text-to-video ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

video

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

Preise

ltx-2.5-fast/text-to-video per second

Spezifikationen	Einzelpreis
1080P	$0.086

Positionierung

ltx-2.5-fast/text-to-video ist die beschleunigte Text-zu-Video-Variante aus der Lightricks-LTX-2.5-Videogenerierungsfamilie und wird über die einheitliche Schnittstelle von HiAPI.ai aufgerufen. Sie geben einen Prompt ein, der Bildinhalt, Bewegung, Kamera und Ton beschreibt, und erhalten einen Videoclip mit nativem Audio. Die Dauer kann in Sekunden gewählt werden, die Ausgabe unterstützt 720p und 1080p, und das Format deckt Quer- und Hochformat ab. Ideal für Entwickler und Content-Teams, die schnell Ergebnisse zur Validierung der Bildsprache benötigen und in hoher Frequenz kurze Videos in Serie erzeugen.

Kernhighlights

Beschleunigte Variante mit Fokus auf Geschwindigkeit – Positioniert als beschleunigte Version der LTX-2.5-Familie, ausgerichtet auf schnelle Ergebnisse, geeignet für wiederholtes Ausprobieren in der Prototypenphase und hochfrequente Massenproduktion.
Bild und Audio in einem Durchgang – Beim Generieren des Videos entsteht gleichzeitig natives Audio, sodass keine separate Nachbearbeitung von Synchronisation oder Soundeffekten nötig ist.
Dauer und Format nach Bedarf – Die Dauer ist in Sekunden zwischen 2 und 20 Sekunden wählbar, unterstützt werden die Formate 16:9 (Querformat) und 9:16 (Hochformat).

Funktionsbeschreibung

Direkt vom Prompt zum Video: Mit einem einzigen Prompt, der Szene, Bewegung, Kamera und Ton beschreibt, liefert das Modell direkt eine Videodatei und erspart Zwischenschritte wie Storyboard und Einzelbildproduktion.

Dauer sekundengenau steuern: Die Dauer kann in ganzen Sekunden zwischen 2 und 20 Sekunden gewählt werden, Standard sind 6 Sekunden; so lässt sich die Clip-Länge präzise an Plattform-Spezifikationen oder den Rhythmus der Einstellung anpassen.

Auflösung und Format wählbar: Die Ausgabe unterstützt 720p und 1080p sowie 16:9 (Querformat) und 9:16 (Hochformat); derselbe Prompt kann Inhalte für verschiedene Platzierungen erzeugen.

Schalter für synchrones Audio: Über einen Parameter lässt sich festlegen, ob natives Audio zusammen mit dem Video erzeugt wird; standardmäßig ist dies aktiviert. Wird kein Ton benötigt, kann es deaktiviert werden, um den anschließenden Schnitt zu vereinfachen.

Anwendungsfälle

Schnelle Validierung der Bildsprache im Kreativteam – Mit kurzen Prompts werden in Serie Kamerastile und Bildkompositionen ausprobiert; die kurzen Clips dienen als Muster zur Auswahl, bevor über eine weitere Ausarbeitung entschieden wird.
Hochformat-Kurzvideomaterial für Social-Media-Betreuung – Material wird im 9:16-Format und mit kurzer Dauer erzeugt und direkt für Kurzvideo-Plattformen, In-Feed-Werbung und andere Hochformat-Platzierungen verwendet.
Massenproduktion von Werbe- und Content-Videos – Anhand einer einheitlichen Prompt-Vorlage werden mehrere Clips mit Audio erzeugt, für Versionstests und die massenhafte Ausspielung derselben Kampagne.
Vorvisualisierung in Film und Animation – Textbeschreibungen aus der Storyboard-Phase werden in dynamische Referenzclips mit Ton umgewandelt, damit Art Design und Schnitt Rhythmus und Atmosphäre vor der eigentlichen Produktion einschätzen können.

Einschränkungen und Auswahlhinweise

Die beschleunigte Positionierung bedeutet einen Kompromiss zwischen Geschwindigkeit und Bildspezifikation; sehr lange Dauer und hohe Auflösung sollten nicht gleichzeitig angestrebt werden: Die maximale Auflösung dieser Variante liegt bei 1080p, die maximale Dauer bei 20 Sekunden, und es werden nur die Formate 16:9 und 9:16 angeboten. Für fertige Videos mit höherer Auflösung oder feinerer Kontrolle der Bildqualität sollte die Pro-Version derselben Familie oder die Bild-zu-Video-Variante geprüft werden; diese Variante eignet sich besser für Prototypenvalidierung und Massenproduktion.

Häufige Fragen

Alle Fragen ansehen →

Welche Auflösungen unterstützt LTX 2.5 Fast?

Zwei Stufen: 720p und 1080p, Standard ist 720p. Das gilt sowohl für Text-zu-Video als auch für Bild-zu-Video.
Wie lang kann ein generiertes Video sein?

2 bis 20 Sekunden; wählbar sind 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18 oder 20 Sekunden, Standard sind 6 Sekunden.
Wird Hochformat unterstützt?

Ja. Setzen Sie aspect_ratio auf 9:16, um ein Video im Hochformat zu erhalten; standardmäßig 16:9 Querformat.
Was ist natives Audio? Kostet es extra?

Nach dem Aktivieren von generate_audio erzeugt das Modell gleichzeitig Umgebungsgeräusche, Soundeffekte oder Hintergrundmusik; standardmäßig aktiviert. Nach dem Deaktivieren erhält man ein stummes Video zum unveränderten Preis.

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: ltx-2.5-fast/text-to-video

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 5000

Text-Prompt zur Beschreibung der zu generierenden Videoszene, der Bildbewegung, der Kamerabewegung sowie des Audioinhalts.

durationintegerOptionalStandard: 6min 2max 20

Videodauer in Sekunden. Standard: 6 Sekunden.

Optionen:2345681012

Alle anzeigen (4)

14161820

resolutionstringOptionalStandard: "720p"

Auflösung des Ausgabevideos. Standard: 720p.

Optionen:720p1080p

aspect_ratiostringOptionalStandard: "16:9"

Seitenverhältnis des Ausgabebildes, das die Quer- oder Hochformat-Ausgabe steuert. Standard: 16:9.

Optionen:16:99:16

generate_audiobooleanOptionalStandard: true

Ob beim Generieren des Videos gleichzeitig natives Audio erzeugt wird. Standard: true.

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": "ltx-2.5-fast/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

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: "ltx-2.5-fast/text-to-video",
    input: {
      "prompt": "…",
      "duration": 6,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }),
});
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": "ltx-2.5-fast/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 6,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True
        }
    },
)
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"
    }
  }
}