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에서 가져오며 그 프레임을 충실히 따릅니다. 문자 그대로의 결과를 얻는 확실한 경로이며, 무검열 시작 프레임도 순화되지 않고 그대로 돌아옵니다. 외형은 이미지가 이미 담고 있으므로 prompt에는 그 이후에 바뀌는 것만 쓰면 됩니다.

숏이 도착할 지점을 정하는 선택 프레임

last_image_url은 마지막 구도를 고정하며 image_url과 함께 보낼 때만 유효합니다. 제약되는 것은 끝이지 그곳까지 가는 경로가 아닙니다. 두 프레임 사이의 움직임은 여전히 생성되므로 긴 클립에서는 중간 부분이 크게 벗어날 수 있습니다. 조명이나 의상이 서로 다른 두 프레임을 주면 둘 사이에서 절충하는 모습이 화면에 드러나므로 연속된 한 쌍으로 준비하십시오.

길이, 해상도, 소리는 텍스트 엔드포인트와 같습니다

duration_seconds는 5~20초 정수 초이며, 클립이 길수록 전달한 종료 프레임에서 더 멀어집니다. resolution은 720p(기본값), 1080p, 2k(너비 약 2560px), 4k 중에서 고릅니다. 출력에는 생성된 오디오 트랙이 포함되고 이를 끄는 필드는 없으므로, 자체 믹스가 필요하다면 편집에서 음소거하거나 교체할 계획을 세우십시오.

승인된 두 프레임 사이의 시간대 전환

beach-to-bonfire 예시에서 image_url은 해 질 녘 해변의 커플을, last_image_url은 밤에 모닥불 곁에서 담요 한 장을 함께 두른 같은 두 사람을 보여 줍니다. 요청은 1080p로 10초이며, prompt는 목적지가 아니라 가는 과정, 즉 해가 지고 모닥불 빛이 그 자리를 이어받는 흐름을 묘사합니다. 끝을 고정해 두면 모델은 중간을 자유롭게 만들되 이미 승인된 프레임을 넘어 벗어나지 않습니다.

편집을 위한 콘티에서 콘티로 이어지는 숏

숏이 한 스토리보드 컷에서 시작해 다른 컷에서 끝나야 한다면 두 장을 image_url과 last_image_url로 보냅니다. 나가는 구도가 다음 컷과 맞물리므로, 생성된 클립을 단독 작품으로만이 아니라 타임라인 안에서 쓸 수 있습니다.

완성된 스틸 이미지에 움직임 더하기

candlelit-tub 프레임에는 이미 촛불, 법랑 욕조, 젖은 에메랄드 실크가 담겨 있어 prompt는 변화만 다룹니다. 물속으로 가라앉고, 젖은 머리카락 사이로 두 손을 쓸어 올리고, 카메라를 향해 눈을 뜨는 흐름입니다. 반면 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 레퍼런스에서 확인하세요.