LTX 2.5 API

LTX 2.5 Текст в видео создаёт по письменному брифу один непрерывный дубль длиной от 5 до 20 целых секунд, в 16:9 или 9:16, в 720p, 1080p, 2K или 4K. Обязателен только prompt; duration_seconds, aspect_ratio и resolution по умолчанию равны 5 секундам, 16:9 и 720p, а seed необязателен. Каждый клип возвращается со сгенерированной звуковой дорожкой. Этот эндпоинт нужен, когда утверждённого изображения ещё нет и место действия, действие и камеру приходится задавать словами. Запросы выполняются как асинхронные задачи: создайте задачу, затем опрашивайте её статус или дождитесь callback.

Выберите режим по исходному материалу

До двадцати секунд в одном дубле

duration_seconds принимает целые секунды от 5 до 20; нижняя граница — 5, а не 3. Двадцати секунд хватает на вход, паузу и выход внутри одного сгенерированного плана, так что непрерывность между этими моментами обеспечивается ещё при генерации, а не на монтаже. Задачи продления в этом семействе моделей нет: длина фиксируется при отправке запроса, и пятисекундный черновик и двадцатисекундный финал — это две отдельные генерации, а не один удлинённый клип.

Четыре разрешения за одним полем

720p, 1080p, 2k и 4k получаются из одной и той же формы запроса, а 2k возвращает кадр шириной около 2560 px. Мизансцену и траекторию камеры можно оценить уже в 720p. Старшие уровни добавляют переплетение ткани, текстуру кожи и блики, поэтому практичный путь — черновик в 720p, а затем один проход в высоком разрешении с тем же seed.

Звук рождается вместе с картинкой

В клипе есть звуковая дорожка, хотя поля для аудио у эндпоинта нет, поэтому и выключить её нечем. Считайте звук частью брифа: пример с оперой заканчивается фразой "orchestra tuning drifting up from the pit". Когда клип ляжет под вашу собственную музыку и шумы, заглушите или замените дорожку на монтаже.

Длинное движение без склеек

Пример arena-gate-to-cages использует максимальные 20 секунд в 1080p и 16:9. Бриф описывает одну траекторию стедикама от ворот арены через забитую людьми трибуну и освещённый факелами тоннель к клеткам за кулисами и прямо говорит "No cuts". Такие планы держатся, только если траектория камеры и декорации сохраняются одновременно, — именно для этого и нужен один длинный дубль.

Черновики, которые становятся 4K-плейтами

Черновик дубля делайте в 720p, сохраните seed и затем один раз запустите тот же промпт в 4K; поле разрешения — единственное изменение. Рендер 4K содержит достаточно деталей, чтобы выдержать цветокоррекцию, перекадрирование и медленный наезд, добавленные позже в монтаже. Пример copper-tub-candlelight отрисован в 2k; в его брифе просят пар, пламя свечи и тонкую фактуру поверхности — именно такие детали и нужны верхним уровням.

Вертикаль, вид от первого лица и иллюстративный стиль

В 9:16 и двадцати секундах проход по подиуму укладывается в одну генерацию: выход, разворот и уход. Бриф bedside-pov уже в первой фразе устанавливает, что камера — это человек, откинувшийся на изголовье кровати, и наблюдаемая сцена превращается в сцену, которая происходит со зрителем. Поля стиля в этом семействе нет, поэтому пример ramen-stall задаёт cel-shading исключительно формулировкой: "Anime cel-shaded animation, hand-painted backgrounds".

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "lightricks/ltx-2.5/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration_seconds": 5
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.