LTX 2.5 API

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

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

Стартовый кадр соблюдается точно

Внешность, гардероб, декорации и свет берутся из image_url, и этот кадр соблюдается точно. Это надёжный путь к буквальному результату: стартовый кадр без цензуры возвращается буквально, а не смягчённым. Раз изображение уже несёт весь облик, промпту остаётся описать только то, что меняется после него.

Необязательный кадр для точки, где план заканчивается

last_image_url фиксирует финальную композицию и допустим только вместе с image_url. Он ограничивает концовку, а не путь к ней: движение между двумя кадрами по-прежнему генерируется, и на длинном клипе середина может уйти далеко. Два кадра, расходящиеся по свету или гардеробу, дают заметный «торг» между ними, поэтому готовьте их как связную пару.

Та же длина, разрешение и звук, что у текстового эндпоинта

duration_seconds — от 5 до 20 целых секунд, и чем длиннее клип, тем дальше он уходит от переданного финального кадра. resolution предлагает 720p (по умолчанию), 1080p, 2k (около 2560 px в ширину) и 4k. В результате есть сгенерированная звуковая дорожка без поля для её отключения; заранее рассчитывайте заглушить или заменить её на монтаже, если нужен собственный микс.

Смена времени суток между двумя утверждёнными кадрами

В примере beach-to-bonfire поле image_url показывает пару на пляже на закате, а last_image_url — тех же двоих ночью, укутанных в одно одеяло у костра. Запрос длится 10 секунд в 1080p, и промпт описывает переход, а не пункт назначения: солнце садится, свет костра берёт верх. Зафиксированная концовка позволяет модели придумать середину, не проскочив мимо уже утверждённого кадра.

От раскадровки к раскадровке для монтажа

Когда план должен начаться на одном кадре раскадровки и закончиться на другом, передайте оба как image_url и last_image_url. Выходная композиция тогда стыкуется со следующей склейкой — именно это делает сгенерированный клип пригодным для таймлайна, а не только как отдельный фрагмент.

Движение для готового кадра

Кадр candlelit-tub уже содержит свечи, эмаль и мокрый изумрудный шёлк, поэтому его промпт описывает только изменение: погружение в воду, руки, проведённые по мокрым волосам, открывающиеся навстречу камере глаза. Пример deco-pool-backfall — наоборот, физический момент: падение спиной в воду, поднимающиеся пузыри и блики, ползущие по колоннам, пока камера опускается вместе с ней.

# 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/image-to-video",
  "input": {
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p"
  }
}'

# 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.