LTX-2 AI
LTX-2 개발자 참고서

LTX-2 API 문서

텍스트 또는 이미지 기반 비동기 영상 작업을 만들고, 반환된 작업 ID를 영상이 준비될 때까지 조회합니다.

기본 URLhttps://ltx-2ai.com
API 키 관리

인증

API 키를 Bearer Token으로 전송하세요. JSON 본문을 보낼 때는 Content-Type: application/json도 포함합니다.

HTTP headers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

영상 생성은 비동기 방식입니다. status를 5~10초마다 조회하세요. 더 짧은 간격은 완료 시간을 줄이지 않습니다.

영상 작업 만들기

POSThttps://ltx-2ai.com/api/video/ltx-2/generate

LTX-2 작업을 만들고 task_id를 즉시 반환합니다. 이 문서는 텍스트·이미지 기반 영상 요청을 다룹니다.

생성 모드

텍스트로 영상 생성

image 없이 prompt를 전송합니다. aspect_ratio로 출력 비율을 지정합니다.

이미지로 영상 생성

prompt와 공개 접근 가능한 이미지 URL을 전송합니다. 입력 이미지가 출력 비율을 결정합니다.

매개변수

이름유형필수설명
typestring아니요선택: text-to-video 또는 image-to-video. image가 있으면 image-to-video가 선택됩니다.
promptstring예영상 설명, 3~2000자. 두 모드 모두 필수입니다.
imagestring아니요공개 이미지 URL. image-to-video에 필수이며 image_url과 imageUrl도 지원합니다.
resolutionstring아니요480p, 720p 또는 1080p. 기본값: 720p.
aspect_ratiostring아니요text-to-video에서 16:9 또는 9:16. 기본값: 16:9.
durationinteger아니요영상 길이 5~20초. 기본값: 5.
seedinteger아니요랜덤 시드. -1은 무작위 결과를 사용합니다.
publicboolean아니요작업을 공개 갤러리에 표시할 수 있는지 여부입니다.

요청 예제

cURL
curl --request POST \
  --url https://ltx-2ai.com/api/video/ltx-2/generate \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image-to-video",
    "prompt": "The subject turns toward the camera and smiles naturally",
    "image": "https://example.com/input.jpg",
    "resolution": "720p",
    "duration": 5,
    "seed": -1
  }'

응답 예제

200 OK
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "IN_PROGRESS",
    "consumed_credits": 24
  }
}

작업 상태 확인

GEThttps://ltx-2ai.com/api/video/ltx-2/status

GET 쿼리로 task_id를 전송합니다. JSON 본문의 POST도 지원합니다. IN_PROGRESS 동안 계속 조회하세요.

매개변수

이름유형필수설명
task_idstring예generate 엔드포인트가 반환한 작업 ID입니다.

요청 예제

cURL
curl --request GET \
  --url 'https://ltx-2ai.com/api/video/ltx-2/status?task_id=n50abc123def456ltx2' \
  --header 'Authorization: Bearer YOUR_API_KEY'

응답 예제

200 OK
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "SUCCESS",
    "consumed_credits": 24,
    "error_message": null,
    "created_at": "2026-08-07T12:00:00Z",
    "request": {
      "type": "image-to-video",
      "prompt": "The subject turns toward the camera and smiles naturally",
      "image": "https://example.com/input.jpg",
      "resolution": "720p",
      "duration": 5
    },
    "response": [
      "https://cdn.example.com/video.mp4"
    ]
  }
}

상태 값

IN_PROGRESS

영상이 대기 중이거나 렌더링 중입니다. 계속 조회하세요.

SUCCESS

생성이 완료되었습니다. response 배열에 영상 URL이 포함됩니다.

FAILED

생성에 실패했습니다. error_message를 확인하세요. 차감된 크레딧은 환불됩니다.

오류 응답

HTTP설명
400필수 매개변수가 없거나 유효하지 않습니다.
401Bearer API 키가 없거나 유효하지 않습니다.
404제공한 task_id의 작업이 없습니다.
405이 엔드포인트에서 해당 HTTP 메서드를 지원하지 않습니다.
500일시적인 생성 또는 상태 오류입니다. 나중에 다시 시도하거나 지원팀에 문의하세요.