Référence développeur LTX-2

Documentation API LTX-2

Créez des tâches asynchrones texte-vers-vidéo ou image-vers-vidéo, puis interrogez l'ID renvoyé jusqu'à ce que la vidéo soit prête.

URL de basehttps://ltx-2ai.com

Gérer les clés API

Authentification

Envoyez votre clé API comme Bearer Token. Ajoutez Content-Type: application/json pour les requêtes avec un corps JSON.

HTTP headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

La génération est asynchrone. Interrogez status toutes les 5-10 secondes ; un intervalle plus court n'accélère pas la tâche.

Créer une tâche vidéo

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

Crée une tâche LTX-2 et renvoie immédiatement un task_id. Cette référence couvre texte-vers-vidéo et image-vers-vidéo.

Modes de génération

Texte vers vidéo

Envoyez prompt sans image. aspect_ratio contrôle le cadrage de sortie.

Image vers vidéo

Envoyez prompt et une URL d'image publique. L'image d'entrée détermine le format de sortie.

Paramètres

Nom	Type	Requis	Description
type	string	Non	Optionnel : text-to-video ou image-to-video. La présence de image sélectionne image-to-video.
prompt	string	Oui	Description de la vidéo, 3-2000 caractères. Requise pour les deux modes.
image	string	Non	URL d'image publique. Requise pour image-to-video ; image_url et imageUrl sont aussi acceptés.
resolution	string	Non	480p, 720p ou 1080p. Par défaut : 720p.
aspect_ratio	string	Non	16:9 ou 9:16 pour text-to-video. Par défaut : 16:9.
duration	integer	Non	Durée de 5 à 20 secondes. Par défaut : 5.
seed	integer	Non	Graine aléatoire. Utilisez -1 pour un résultat aléatoire.
public	boolean	Non	Indique si la tâche peut apparaître dans les galeries publiques.

Exemple de requête

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
  }'

Exemple de réponse

200 OK

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

Vérifier le statut

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

Envoyez task_id dans la query GET. POST avec un corps JSON est aussi accepté. Continuez tant que le statut est IN_PROGRESS.

Paramètres

Nom	Type	Requis	Description
task_id	string	Oui	ID de tâche renvoyé par l'endpoint generate.

Exemple de requête

cURL

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

Exemple de réponse

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"
    ]
  }
}

Valeurs de statut

IN_PROGRESS

La vidéo est en file d'attente ou en rendu. Continuez à interroger.

SUCCESS

La génération est terminée. Le tableau response contient l'URL de la vidéo.

FAILED

La génération a échoué. Consultez error_message ; les crédits débités sont remboursés.

Réponses d'erreur

HTTP	Description
400	Un paramètre requis est absent ou invalide.
401	La clé API Bearer est absente ou invalide.
404	Aucune tâche ne correspond au task_id fourni.
405	La méthode HTTP n'est pas prise en charge par cet endpoint.
500	Erreur temporaire de génération ou de statut. Réessayez plus tard ou contactez le support.