LTX-2 Entwicklerreferenz

LTX-2 API-Dokumentation

Erstellen Sie asynchrone Text-zu-Video- oder Bild-zu-Video-Aufgaben und fragen Sie die zurückgegebene Aufgaben-ID bis zur Fertigstellung ab.

Basis-URLhttps://ltx-2ai.com

API-Schlüssel verwalten

Authentifizierung

Senden Sie den API-Schlüssel als Bearer Token. Bei JSON-Anfragen ist zusätzlich Content-Type: application/json erforderlich.

HTTP headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Die Generierung läuft asynchron. Fragen Sie status alle 5-10 Sekunden ab; kürzere Intervalle beschleunigen die Aufgabe nicht.

Videoaufgabe erstellen

POSThttps://ltx-2ai.com/api/video/ltx-2/generate

Erstellt eine LTX-2-Aufgabe und gibt sofort eine task_id zurück. Diese Referenz deckt Text-zu-Video und Bild-zu-Video ab.

Generierungsmodi

Text zu Video

Senden Sie prompt ohne image. aspect_ratio steuert das Ausgabeformat.

Bild zu Video

Senden Sie prompt und eine öffentlich erreichbare Bild-URL. Das Eingabebild bestimmt das Seitenverhältnis.

Parameter

Name	Typ	Erforderlich	Beschreibung
type	string	Nein	Optional: text-to-video oder image-to-video. Mit image wird image-to-video gewählt.
prompt	string	Ja	Videobeschreibung mit 3-2000 Zeichen. Für beide Modi erforderlich.
image	string	Nein	Öffentliche Bild-URL. Für image-to-video erforderlich; image_url und imageUrl werden ebenfalls akzeptiert.
resolution	string	Nein	480p, 720p oder 1080p. Standard: 720p.
aspect_ratio	string	Nein	16:9 oder 9:16 für text-to-video. Standard: 16:9.
duration	integer	Nein	Videolänge von 5-20 Sekunden. Standard: 5.
seed	integer	Nein	Zufalls-Seed. -1 erzeugt ein zufälliges Ergebnis.
public	boolean	Nein	Ob die Aufgabe in öffentlichen Galerien erscheinen darf.

Anfragebeispiel

cURL

curl --request POST \
  --url https://ltx-2ai.com/api/video/ltx-2/generate \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image-to-video",
    "prompt": "The subject turns toward the camera and smiles naturally",
    "image": "https://example.com/input.jpg",
    "resolution": "720p",
    "duration": 5,
    "seed": -1
  }'

Antwortbeispiel

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "IN_PROGRESS",
    "consumed_credits": 24
  }
}

Aufgabenstatus prüfen

GEThttps://ltx-2ai.com/api/video/ltx-2/status

Senden Sie task_id als GET-Query. POST mit JSON wird ebenfalls unterstützt. Bei IN_PROGRESS weiter abfragen.

Parameter

Name	Typ	Erforderlich	Beschreibung
task_id	string	Ja	Vom generate-Endpunkt zurückgegebene Aufgaben-ID.

Anfragebeispiel

cURL

curl --request GET \
  --url 'https://ltx-2ai.com/api/video/ltx-2/status?task_id=n50abc123def456ltx2' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Antwortbeispiel

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "SUCCESS",
    "consumed_credits": 24,
    "error_message": null,
    "created_at": "2026-08-07T12:00:00Z",
    "request": {
      "type": "image-to-video",
      "prompt": "The subject turns toward the camera and smiles naturally",
      "image": "https://example.com/input.jpg",
      "resolution": "720p",
      "duration": 5
    },
    "response": [
      "https://cdn.example.com/video.mp4"
    ]
  }
}

Statuswerte

IN_PROGRESS

Das Video wartet oder wird gerendert. Weiter abfragen.

SUCCESS

Die Generierung ist abgeschlossen. response enthält die Video-URL.

FAILED

Die Generierung ist fehlgeschlagen. Details stehen in error_message; abgezogene Credits werden erstattet.

Fehlerantworten

HTTP	Beschreibung
400	Ein erforderlicher Parameter fehlt oder ist ungültig.
401	Der Bearer API-Schlüssel fehlt oder ist ungültig.
404	Für die angegebene task_id wurde keine Aufgabe gefunden.
405	Die HTTP-Methode wird von diesem Endpunkt nicht unterstützt.
500	Temporärer Generierungs- oder Statusfehler. Später erneut versuchen oder Support kontaktieren.