LTX-2 geliştirici referansı

LTX-2 API dokümantasyonu

Metinden veya görselden eşzamansız video görevleri oluşturun ve dönen görev kimliğini video hazır olana kadar sorgulayın.

Temel URLhttps://ltx-2ai.com

API anahtarlarını yönet

Kimlik doğrulama

API anahtarını Bearer Token olarak gönderin. JSON gövdesi gönderirken Content-Type: application/json ekleyin.

HTTP headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Video üretimi eşzamansızdır. status uç noktasını 5-10 saniyede bir sorgulayın; daha kısa aralıklar görevi hızlandırmaz.

Video görevi oluştur

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

Bir LTX-2 görevi oluşturur ve hemen task_id döndürür. Bu referans metinden ve görselden video isteklerini kapsar.

Üretim modları

Metinden video

image olmadan prompt gönderin. Çıktı oranını aspect_ratio belirler.

Görselden video

prompt ve herkese açık bir görsel URL'si gönderin. Çıktı oranını giriş görseli belirler.

Parametreler

Ad	Tür	Zorunlu	Açıklama
type	string	Hayır	İsteğe bağlı: text-to-video veya image-to-video. image verilirse image-to-video seçilir.
prompt	string	Evet	Video açıklaması, 3-2000 karakter. Her iki modda zorunludur.
image	string	Hayır	Herkese açık görsel URL'si. image-to-video için zorunlu; image_url ve imageUrl de kabul edilir.
resolution	string	Hayır	480p, 720p veya 1080p. Varsayılan: 720p.
aspect_ratio	string	Hayır	text-to-video için 16:9 veya 9:16. Varsayılan: 16:9.
duration	integer	Hayır	Video süresi 5-20 saniye. Varsayılan: 5.
seed	integer	Hayır	Rastgelelik tohumu. Rastgele sonuç için -1 kullanın.
public	boolean	Hayır	Görevin herkese açık galerilerde gösterilip gösterilemeyeceği.

İstek örneği

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

Yanıt örneği

200 OK

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

Görev durumunu kontrol et

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

task_id değerini GET sorgusu olarak gönderin. JSON gövdeli POST da desteklenir. IN_PROGRESS durumunda sorgulamaya devam edin.

Parametreler

Ad	Tür	Zorunlu	Açıklama
task_id	string	Evet	generate uç noktasının döndürdüğü görev kimliği.

İstek örneği

cURL

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

Yanıt örneği

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

Durum değerleri

IN_PROGRESS

Video sırada veya işleniyor. Sorgulamaya devam edin.

SUCCESS

Üretim tamamlandı. response dizisi video URL'sini içerir.

FAILED

Üretim başarısız oldu. error_message ayrıntıları içerir; düşülen krediler iade edilir.

Hata yanıtları

HTTP	Açıklama
400	Zorunlu bir parametre eksik veya geçersiz.
401	Bearer API anahtarı eksik veya geçersiz.
404	Verilen task_id için görev bulunamadı.
405	HTTP yöntemi bu uç nokta tarafından desteklenmiyor.
500	Geçici üretim veya durum hatası. Daha sonra tekrar deneyin ya da destekle iletişime geçin.