LTX-2 AI
Справочник разработчика LTX-2

Документация LTX-2 API

Создайте асинхронную задачу генерации видео из текста или изображения, затем опрашивайте полученный ID до готовности видео.

Базовый URLhttps://ltx-2ai.com
Управление API-ключами

Аутентификация

Передавайте API-ключ как Bearer Token. Для запросов с JSON также добавьте Content-Type: application/json.

HTTP headers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Генерация выполняется асинхронно. Опрашивайте status каждые 5-10 секунд; более частые запросы не ускоряют задачу.

Создание видеозадачи

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

Создает задачу LTX-2 и сразу возвращает task_id. Здесь описаны запросы из текста и изображения.

Режимы генерации

Текст в видео

Отправьте prompt без image. Формат кадра задается через aspect_ratio.

Изображение в видео

Отправьте prompt и публичный URL изображения. Формат определяется исходным изображением.

Параметры

ИмяТипОбязательноОписание
typestringНетНеобязательно: text-to-video или image-to-video. При наличии image выбирается image-to-video.
promptstringДаОписание видео, 3-2000 символов. Обязательно в обоих режимах.
imagestringНетПубличный URL изображения. Обязателен для image-to-video; также принимаются image_url и imageUrl.
resolutionstringНет480p, 720p или 1080p. По умолчанию: 720p.
aspect_ratiostringНет16:9 или 9:16 для text-to-video. По умолчанию: 16:9.
durationintegerНетДлительность видео 5-20 секунд. По умолчанию: 5.
seedintegerНетСлучайное зерно. Значение -1 дает случайный результат.
publicbooleanНетМожет ли задача отображаться в публичных галереях.

Пример запроса

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

Пример ответа

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

Проверка статуса задачи

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

Передайте task_id в GET query. Также поддерживается POST с JSON. Продолжайте опрос при IN_PROGRESS.

Параметры

ИмяТипОбязательноОписание
task_idstringДаID задачи, возвращенный endpoint generate.

Пример запроса

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

Пример ответа

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

Значения статуса

IN_PROGRESS

Видео в очереди или рендерится. Продолжайте опрос.

SUCCESS

Генерация завершена. Массив response содержит URL видео.

FAILED

Генерация не удалась. Подробности в error_message; списанные кредиты возвращаются.

Ошибки

HTTPОписание
400Обязательный параметр отсутствует или недействителен.
401Bearer API-ключ отсутствует или недействителен.
404Задача с указанным task_id не найдена.
405HTTP-метод не поддерживается этим endpoint.
500Временная ошибка генерации или статуса. Повторите позже или обратитесь в поддержку.