소개
LTX 2.5 이미지→영상은 직접 제공한 시작 프레임을 5~20초(정수 초) 동안 움직여 720p, 1080p, 2K, 4K로 출력합니다. 필수 필드는 image_url과 prompt이고, last_image_url을 더하면 선택 사항인 종료 프레임을 지정할 수 있으며, duration_seconds, resolution, seed는 텍스트→영상과 똑같이 동작합니다. aspect_ratio 필드는 없습니다. 시작 프레임이 피사체와 구도를 정하고 출력 형태도 결정합니다. 클립에는 생성된 사운드트랙이 함께 나오고 작업은 비동기로 실행됩니다. 사용 권한이 있는 이미지만 업로드하십시오. 결과물의 사용 방식에 대한 책임은 사용자에게 있습니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 브리프가 장면, 행동, 카메라, 필요한 경우 사운드를 정합니다. | LTX 2.5 텍스트→영상 |
| 승인된 시작 이미지가 피사체와 구성을 정하고, 지시문이 이후의 움직임을 이끕니다. | LTX 2.5 이미지→영상 |
핵심 기능 및 하이라이트
시작 프레임을 충실히 따릅니다
인물, 의상, 세트, 조명은 image_url에서 가져오며 그 프레임을 충실히 따릅니다. 문자 그대로의 결과를 얻는 확실한 경로이며, 무검열 시작 프레임도 순화되지 않고 그대로 돌아옵니다. 외형은 이미지가 이미 담고 있으므로 prompt에는 그 이후에 바뀌는 것만 쓰면 됩니다.
숏이 도착할 지점을 정하는 선택 프레임
last_image_url은 마지막 구도를 고정하며 image_url과 함께 보낼 때만 유효합니다. 제약되는 것은 끝이지 그곳까지 가는 경로가 아닙니다. 두 프레임 사이의 움직임은 여전히 생성되므로 긴 클립에서는 중간 부분이 크게 벗어날 수 있습니다. 조명이나 의상이 서로 다른 두 프레임을 주면 둘 사이에서 절충하는 모습이 화면에 드러나므로 연속된 한 쌍으로 준비하십시오.
길이, 해상도, 소리는 텍스트 엔드포인트와 같습니다
duration_seconds는 5~20초 정수 초이며, 클립이 길수록 전달한 종료 프레임에서 더 멀어집니다. resolution은 720p(기본값), 1080p, 2k(너비 약 2560px), 4k 중에서 고릅니다. 출력에는 생성된 오디오 트랙이 포함되고 이를 끄는 필드는 없으므로, 자체 믹스가 필요하다면 편집에서 음소거하거나 교체할 계획을 세우십시오.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수입니다. 프레임 다음에 달라지는 동작과 카메라, 빛을 적으세요. 1자 이상 |
image_url | 예 | 첫 프레임입니다. 피사체와 구도를 고정하고 출력 형태도 정합니다. |
last_image_url | 아니요 | 선택인 마지막 프레임이고 image_url과 함께일 때만 유효합니다. 경로가 아니라 결말을 고정합니다. |
resolution | 아니요 | 720p, 1080p, 2k, 4k 중에서 고릅니다. 2k는 가로 약 2560px로 나옵니다. |
duration_seconds | 아니요 | 정수 초로 5에서 20까지입니다. 클립이 길수록 지정한 마지막 프레임에서 더 멀리 헤맵니다. |
seed | 아니요 | 해상도를 올릴 때는 고정해 두세요. 그래야 바뀐 변수가 하나뿐입니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.09 / 초 |
| $0.13 / 초 |
| $0.19 / 초 |
| $0.30 / 초 |
활용 사례
승인된 두 프레임 사이의 시간대 전환
beach-to-bonfire 예시에서 image_url은 해 질 녘 해변의 커플을, last_image_url은 밤에 모닥불 곁에서 담요 한 장을 함께 두른 같은 두 사람을 보여 줍니다. 요청은 1080p로 10초이며, prompt는 목적지가 아니라 가는 과정, 즉 해가 지고 모닥불 빛이 그 자리를 이어받는 흐름을 묘사합니다. 끝을 고정해 두면 모델은 중간을 자유롭게 만들되 이미 승인된 프레임을 넘어 벗어나지 않습니다.
편집을 위한 콘티에서 콘티로 이어지는 숏
숏이 한 스토리보드 컷에서 시작해 다른 컷에서 끝나야 한다면 두 장을 image_url과 last_image_url로 보냅니다. 나가는 구도가 다음 컷과 맞물리므로, 생성된 클립을 단독 작품으로만이 아니라 타임라인 안에서 쓸 수 있습니다.
완성된 스틸 이미지에 움직임 더하기
candlelit-tub 프레임에는 이미 촛불, 법랑 욕조, 젖은 에메랄드 실크가 담겨 있어 prompt는 변화만 다룹니다. 물속으로 가라앉고, 젖은 머리카락 사이로 두 손을 쓸어 올리고, 카메라를 향해 눈을 뜨는 흐름입니다. 반면 deco-pool-backfall 예시는 물리적인 순간으로, 뒤로 넘어지듯 물에 빠지고 기포가 떠오르며 커스틱이 기둥 위를 기어가는 동안 카메라도 함께 가라앉습니다.
프롬프트 가이드 및 실전 팁
이미 있는 것이 아니라 바뀌는 것을 쓰십시오
시작 프레임에 보이는 모든 것은 이미지가 정합니다. prompt는 누가, 어느 방향으로, 어떤 속도로 움직이는지에 쓰고 이어서 카메라와 조명 변화를 적으십시오. candlelit-tub의 prompt는 첫 동작(‘She pushes up off the rim of the tub’)으로 시작해 ‘Slow drift-in, warm candle light only’로 끝납니다.
종료 프레임을 보낼 때는 도착 지점을 글로 밝히십시오
last_image_url을 쓸 때는 숏이 전달한 최종 프레임에서 끝난다는 점을 prompt에 적고, 그 사이에 일어나는 일을 설명합니다. 모닥불 브리프가 정확히 그렇게 합니다. ‘Begin on the two of them on the beach at sunset and end on the supplied final frame’. 무엇이든 쓰기 전에 두 이미지의 피사체, 의상, 조명을 맞춰 두십시오.
이동 거리에 맞춰 길이를 정하십시오
동작이 하나뿐인 예시는 5초, 해 질 녘에서 밤으로 넘어가는 전환은 10초를 씁니다. 짧은 클립으로 시작해 출력 전체에 걸쳐 피사체, 윤곽, 조명, 카메라 연속성을 확인한 뒤 길이를 늘리십시오. 수영장 예시처럼 물이 나오는 숏은 프레임 단위로 넘겨 보십시오. 스틸 이미지를 움직일 때 가장 쉽게 무너지는 곳이 물이기 때문입니다.
소리를 연출하고 seed를 고정하십시오
오디오는 항상 생성되므로 소리도 prompt에 적습니다. 수영장 브리프는 ‘no music, only muffled underwater tone’을 요구합니다. 움직임이 맞으면 seed와 prompt는 그대로 두고 resolution만 올리십시오. seed는 실행끼리 비교할 수 있게 해 줄 뿐 프레임 단위로 같게 만들지는 않으므로, 최종 렌더는 전체 해상도에서 다시 확인하십시오.
API 빠른 시작
# 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 레퍼런스에서 확인하세요.
