Skip to main content
LTX에서 제공하고 Comfy Router가 서비스하는 ltx/ltx-2-5-pro의 API 레퍼런스입니다.

빠른 시작

Comfy 워크스페이스에서 키를 생성하고 COMFY_API_KEY로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. 모델 ID: ltx/ltx-2-5-pro 엔드포인트: POST https://api.comfy.org/v2/models/ltx/ltx-2-5-pro

Schema

Input

integer
필수
비디오 재생 시간(초)입니다(최대값은 해상도와 프레임 레이트에 따라 달라집니다).가능한 값: 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18, 20
integer
기본값:"25"
초당 프레임 수 단위의 프레임 레이트입니다.가능한 값: 24, 25, 48, 50
boolean
기본값:"true"
비디오용 오디오를 생성합니다.
string
생성에 사용할 모델입니다. Comfy Router 경로 POST /v2/models/ltx/{model}에서는 이 필드가 경로에서 제공되므로 생략할 수 있습니다. 이 작업에서 LTX가 제공하는 표기, 즉 Comfy Router가 ltx/<model>로 주소 지정하는 집합은 ltx-2-5-fast와 ltx-2-5-pro입니다. 위 주석에 제시된 이유로 여기서는 enum으로 제한하지 않고 그대로 나열합니다. 각 모델이 허용하는 해상도는 아래 resolution 속성의 x-comfy-model-resolutions 매트릭스에 있습니다.
string
필수
원하는 비디오 콘텐츠를 설명하는 텍스트 프롬프트입니다.
string
필수
출력 비디오 해상도입니다. enum은 모든 모델에 대한 합집합이며, 지원되는 집합은 모델별로 다릅니다. 지원되는 조합: ltx-2-5-fast: 1280x720, 720x1280, 1920x1080, 1080x1920, 2560x1440, 1440x2560, 3840x2160, 2160x3840; ltx-2-5-pro: 1280x720, 720x1280, 1920x1080, 1080x1920. 그 밖의 (모델, 해상도) 조합은 지원되지 않으며, v2 경로는 이를 400으로 거부합니다. 동일한 매트릭스가 이 속성의 x-comfy-model-resolutions 확장에 기계 판독 가능한 형태로 게시되어 있습니다.가능한 값: 1280x720, 720x1280, 1920x1080, 1080x1920, 2560x1440, 1440x2560, 3840x2160, 2160x3840
Router가 GET /v2/models/ltx/ltx-2-5-pro/openapi.json에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 동일한 문서입니다.

Output

string
작업 완료 타임스탬프(ISO 8601)
string
작업 생성 타임스탬프(ISO 8601)
object
status가 failed일 때 존재합니다.
string
string
string
고유한 작업 식별자
object
status가 completed일 때 존재합니다. 출력 URL은 완료 후 24시간 뒤에 만료됩니다.
string
생성된 비디오의 URL
string
작업 상태(pending, processing, completed, failed)

예시

입력

출력

배포 전 확인

SDK는 Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다. 요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.

헤더

인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.

Router API 사용

모델 검색, 유효성 검사 오류, 재시도, 과금.

제한 사항

Router가 현재 지원하지 않는 기능과 대체 방법.