소개
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을 기다리면 됩니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 브리프가 장면, 행동, 카메라, 필요한 경우 사운드를 정합니다. | LTX 2.5 텍스트→영상 |
| 승인된 시작 이미지가 피사체와 구성을 정하고, 지시문이 이후의 움직임을 이끕니다. | LTX 2.5 이미지→영상 |
핵심 기능 및 하이라이트
한 테이크에 최대 20초
duration_seconds는 5부터 20까지 정수 초를 받으며 최솟값은 3이 아니라 5입니다. 20초면 생성된 컷 하나 안에 등장, 머무름, 퇴장을 담을 수 있어 그 사이의 연속성이 편집이 아니라 생성 단계에서 유지됩니다. 이 모델 계열에는 연장 작업이 없습니다. 길이는 요청을 보낼 때 정해지고, 5초짜리 초안과 20초짜리 최종본은 클립 하나를 늘린 것이 아니라 서로 다른 생성입니다.
필드 하나로 고르는 네 가지 해상도
720p, 1080p, 2k, 4k는 모두 같은 요청 형태에서 나오며 2k는 너비 약 2560px의 프레임을 돌려줍니다. 배치와 카메라 경로는 720p에서도 이미 판단할 수 있습니다. 상위 해상도가 더해 주는 것은 원단의 짜임, 피부 질감, 반사광 디테일입니다. 그래서 실무에서는 720p로 초안을 만든 뒤 seed를 그대로 두고 고해상도로 한 번만 출력하는 흐름이 효율적입니다.
소리는 영상과 함께 생성됩니다
이 엔드포인트에는 오디오 필드가 없지만 클립에는 오디오 트랙이 들어 있어 끌 방법이 없습니다. 소리도 브리프의 일부로 적어 주십시오. 오페라 예시는 ‘orchestra tuning drifting up from the pit’로 끝납니다. 직접 준비한 음악과 효과음을 얹을 때는 편집에서 트랙을 음소거하거나 교체하면 됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 전체 흐름을 한 컷처럼 쓰세요. 피사체, 동작, 카메라, 빛 순서로 적으면 됩니다. 1자 이상 |
resolution | 아니요 | 720p, 1080p, 2k, 4k 중에서 고릅니다. 720p로 초안을 잡고 이긴 컷을 2k나 4k에서 다시 돌리세요. |
aspect_ratio | 아니요 | 16:9 또는 9:16뿐입니다. 정사각도, 4:3도, 아나모픽 프레임도 여기엔 없습니다. |
duration_seconds | 아니요 | 정수 초로 5에서 20까지입니다. 잘라내기가 아니라 생성 파라미터이니 미리 정하세요. |
seed | 아니요 | 해상도를 올릴 때는 고정해 두세요. 그래야 바뀐 변수가 하나뿐입니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.09 / 초 |
| $0.13 / 초 |
| $0.19 / 초 |
| $0.30 / 초 |
활용 사례
컷 없이 이어지는 긴 이동 숏
arena-gate-to-cages 예시는 최대치인 20초를 1080p, 16:9로 사용합니다. 브리프는 경기장 게이트에서 출발해 사람으로 꽉 찬 관중석과 횃불이 밝힌 터널을 지나 무대 뒤 우리까지 이어지는 스테디캠 경로 하나를 묘사하고 ‘No cuts’라고 분명히 적습니다. 이런 숏은 카메라 경로와 세트가 동시에 버텨야 성립하며, 긴 원테이크가 바로 그 용도입니다.
4K 플레이트로 이어지는 초안
테이크는 720p로 초안을 잡고 시드를 유지한 뒤, 같은 프롬프트를 한 번 4K로 실행하십시오. 바꾸는 것은 해상도 항목 하나뿐입니다. 4K 렌더에는 편집 후반에 더하는 그레이딩, 리프레임, 느린 푸시를 견딜 만큼의 디테일이 있습니다. copper-tub-candlelight 예시는 2k로 렌더링되었습니다. 그 브리프는 김, 촛불 불꽃, 섬세한 표면 질감을 요구하며, 상위 단계가 담당해야 할 종류의 디테일입니다.
세로형, 1인칭 시점, 일러스트 화풍
9:16에서 20초면 런웨이 등장, 턴, 퇴장을 한 번의 생성에 담을 수 있습니다. bedside-pov 브리프는 첫 문장에서 카메라가 침대 헤드보드에 기대 누운 사람이라고 못 박아, 지켜보는 장면을 시청자에게 일어나는 장면으로 바꿉니다. 이 모델 계열에는 스타일 필드가 없으므로 ramen-stall 예시는 셀 셰이딩 화풍을 ‘Anime cel-shaded animation, hand-painted backgrounds’라는 문구만으로 지정합니다.
프롬프트 가이드 및 실전 팁
일어나는 순서대로 숏을 쓰십시오
전체 흐름을 한 단락에 담고 피사체, 동작, 카메라, 조명을 일어나는 순서대로 적습니다. opera-staircase 브리프가 좋은 본보기입니다. 그녀가 누구이며 무엇을 입었는지, 이어서 계단을 내려오는 동작과 걸음마다 열리는 슬릿, 이어서 원단을 투과하는 빛, 이어서 ‘Slow crane down’, 마지막으로 소리 순입니다. 카메라 지시는 그 지시가 반응하는 동작 바로 옆에 두십시오.
첫 단어를 쓰기 전에 길이와 화면비를 정하십시오
먼저 duration_seconds와 aspect_ratio를 고릅니다. 이 두 값이 브리프가 감당해야 할 동작의 양을 정하기 때문입니다. 20초짜리 경기장 브리프는 여러 장소를 이어 붙이고, 5초짜리 브리프들은 각각 동작 하나와 그 마무리만 묘사합니다. 화면비는 16:9와 9:16뿐이어서 정사각형이나 4:3 결과물은 이 엔드포인트에서 만들 수 없습니다.
한 번 실행할 때 하나만 바꾸십시오
문장 하나를 고치거나 해상도를 올릴 때 seed를 고정해 비교가 그 한 가지 변화만 가려내도록 합니다. 고정된 seed는 두 실행을 비교 가능하게 만들 뿐 프레임 단위로 같은 클립을 보장하지 않습니다. 고해상도 결과가 초안과 같다고 가정하지 말고 다시 확인하십시오.
글로 하는 연출의 한계를 아십시오
글로 쓴 숏은 의상, 몸, 프레이밍을 모델에 맡기며 다시 실행할 때마다 달라집니다. 그 차이는 5초보다 20초에서 더 두드러집니다. 얼굴, 제품, 구도를 승인된 그대로 유지해야 한다면 LTX 2.5 이미지→영상으로 옮겨 그 프레임을 image_url로 전달하십시오.
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/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 레퍼런스에서 확인하세요.
