LTX 2.5 API

LTX 2.5 Obraz na wideo animuje dostarczoną przez ciebie klatkę otwierającą przez 5–20 pełnych sekund, w 720p, 1080p, 2K lub 4K. Wymagane są image_url i prompt; last_image_url dodaje opcjonalną klatkę końcową, a duration_seconds, resolution i seed działają tak samo jak w Tekst na wideo. Pola aspect_ratio nie ma: klatka otwierająca ustala postać i kompozycję oraz wyznacza format wyjścia. Klipy wracają z wygenerowaną ścieżką dźwiękową, a zadania są wykonywane asynchronicznie. Przesyłaj tylko obrazy, do których użycia masz prawo; za sposób wykorzystania wyniku odpowiadasz ty.

Wybierz tryb według materiału początkowego

Klatka otwierająca jest ściśle przestrzegana

Tożsamość, kostiumy, scenografia i światło pochodzą z image_url, a ta klatka jest ściśle przestrzegana. To pewna droga do dosłownego wyniku: klatka otwierająca bez cenzury wraca dosłownie, a nie złagodzona. Skoro obraz niesie już wygląd, prompt musi opisać tylko to, co zmienia się później.

Opcjonalna klatka dla miejsca, w którym ujęcie się kończy

last_image_url ustala kompozycję końcową i jest ważny tylko razem z image_url. Ogranicza zakończenie, a nie drogę do niego: ruch między dwiema klatkami nadal jest generowany, a w długim klipie środek potrafi odejść daleko. Dwie klatki, które nie zgadzają się co do światła lub kostiumów, dają widoczne negocjowanie między nimi, dlatego przygotuj je jako spójną parę.

Ta sama długość, rozdzielczość i dźwięk co w endpoincie tekstowym

duration_seconds obejmuje od 5 do 20 pełnych sekund, a dłuższe klipy oddalają się bardziej od dostarczonej klatki końcowej. resolution oferuje 720p (domyślnie), 1080p, 2k (około 2560 px szerokości) i 4k. Wyjście zawiera wygenerowaną ścieżkę audio bez pola do jej wyłączenia; zaplanuj jej wyciszenie lub podmianę w montażu, gdy potrzebujesz własnego miksu.

Zmiana pory dnia między dwiema zatwierdzonymi klatkami

W przykładzie beach-to-bonfire pole image_url pokazuje parę na plaży o zachodzie słońca, a last_image_url tych samych dwoje nocą, owiniętych jednym kocem przy ognisku. Żądanie trwa 10 sekund w 1080p, a prompt opisuje przejście, a nie cel: zachodzące słońce i przejmujące je światło ognia. Przypięcie zakończenia pozwala modelowi wymyślić środek bez wychodzenia poza klatkę, którą już zatwierdzono.

Od planszy do planszy na potrzeby montażu

Gdy ujęcie ma zacząć się na jednej klatce storyboardu i skończyć na innej, wyślij obie jako image_url i last_image_url. Kompozycja wyjściowa pasuje wtedy do następnego cięcia, i to właśnie sprawia, że wygenerowany klip nadaje się do osi czasu, a nie tylko jako samodzielny fragment.

Ruch dla gotowego kadru

Klatka candlelit-tub zawiera już świece, emalię i mokry szmaragdowy jedwab, więc jej prompt obejmuje tylko zmianę: zanurzenie w wodzie, przeciągnięcie dłoni przez mokre włosy, otwarcie oczu w stronę kamery. Przykład deco-pool-backfall to z kolei moment fizyczny: upadek na plecy do wody, wznoszące się bąbelki i refleksy pełzające po kolumnach, podczas gdy kamera opada razem z nią.

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

Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.