LTX-2 API 사용법

LTX-2 API는 개발자들이 인공지능을 통해 매력적인 비디오 콘텐츠를 만들 수 있도록 지원합니다. Lightricks에서 제공하는 이 서비스는 사용자가 텍스트 설명이나 정적 이미지를 오디오가 동기화된 비디오로 변환할 수 있게 합니다. 엔지니어들은 콘텐츠 제작부터 시각 효과 프로토타입 제작에 이르는 다양한 작업에 이 API를 애플리케이션에 통합합니다. 또한, 이 API는 속도 또는 품질에 최적화된 다양한 모델을 지원하여 프로젝트 요구사항에 따라 맞춤화할 수 있습니다.

💡

요청을 효과적으로 테스트하고 관리하기 위해 개발자들은 종종 전문 도구를 활용합니다. 예를 들어, Apidog는 API 호출을 구축하고 전송하며 디버깅하기 위한 사용자 친화적인 인터페이스를 제공합니다. 인증 헤더, JSON 페이로드, 응답 파싱을 원활하게 처리합니다.

버튼

따라서, LTX-2 API와의 상호작용을 향상시키고 설정보다는 혁신에 더 집중할 수 있도록 Apidog를 무료로 다운로드해 보세요.

LTX-2 API란 무엇인가요?

개발자들은 LTX-2 API를 사용하여 프로그램을 통해 비디오를 생성합니다. 이 RESTful 서비스는 고급 AI 모델을 활용하여 간단한 입력으로부터 영화와 같은 결과물을 만들어냅니다. 구체적으로, 이 서비스는 텍스트-투-비디오 생성, 이미지-투-비디오 변환, 그리고 비디오 세그먼트 편집을 위한 재촬영(retake) 기능이라는 세 가지 핵심 기능을 제공합니다.

이 API는 한 번에 동기화된 오디오와 비디오를 생성하는 확산 트랜스포머(DiT) 기반의 LTX-2 모델을 기반으로 합니다. 사용자는 프롬프트를 제출하고, 시스템은 선택된 모델과 구성에 따라 최대 20초 길이의 비디오를 렌더링합니다. 또한, 4K와 같은 고해상도 및 최대 50 FPS의 프레임 속도를 지원하여 전문적인 애플리케이션에 적합합니다.

Lightricks는 API를 호스팅하여 확장성과 신뢰성을 보장합니다. 사용자는 HTTPS 엔드포인트를 통해 API에 접근하며, 응답은 MP4 파일을 직접 전달합니다. 이 동기식 접근 방식은 상태 폴링 없이 응답 본문에서 생성된 비디오를 받을 수 있으므로 워크플로우를 단순화합니다. 그러나 과부하를 방지하기 위해 사용량 제한이 적용되므로 팀은 사용량을 신중하게 모니터링해야 합니다.

오픈 소스 대안과 비교하여, 호스팅되는 LTX-2 API는 하드웨어 요구사항을 추상화합니다. 개발자는 GPU를 관리하거나 ComfyUI와 같은 프레임워크를 설치하는 대신 통합에 집중할 수 있습니다. 그럼에도 불구하고 로컬 실행을 선호하는 사람들을 위해 Lightricks는 GitHub에서 오픈 소스 LTX-2 모델을 제공하지만, 이 가이드에서는 클라우드 기반 효율성을 위한 API를 강조합니다.

LTX-2 API 시작하기

사용자는 자격 증명을 얻는 것으로 시작합니다. 먼저, 개발자 콘솔에 로그인하세요. 필요하다면 플랫폼이 계정 생성 과정을 안내합니다. 로그인 후 대시보드에서 API 키를 직접 생성하세요.

이 키는 액세스 토큰으로 사용됩니다. 모든 요청을 인증하므로 안전하게 보관하세요. 예를 들어, 스크립트에 하드코딩하는 것을 피하기 위해 환경 변수에 저장하세요. Bash에서는 export LTXV_API_KEY="your_key_here"를 실행하세요. Python 개발자들은 import os; api_key = os.environ.get("LTXV_API_KEY")를 사용하여 이를 검색합니다. Node.js 사용자는 process.env.LTXV_API_KEY를 통해 접근합니다.

키를 확보한 후 간단한 요청으로 연결을 테스트하세요. curl 또는 Apidog와 같은 도구를 사용하여 설정을 확인하세요. 이 단계는 계정 상태를 확인하고 API의 응답 형식을 숙지하는 데 도움이 됩니다. 문제가 발생하면 401 상태를 반환하는 유효하지 않은 키와 같은 일반적인 오류를 확인하세요.

또한, 콘솔에서 요금제 세부 정보를 검토하세요. 다른 등급은 다양한 크레딧과 제한을 제공하며, 비디오 생성 빈도에 영향을 미칩니다. 팀은 더 많은 볼륨을 지원하기 위해 필요에 따라 요금제를 업그레이드합니다.

LTX-2 API에서 요청을 인증하는 방법은 무엇인가요?

인증은 API 접근을 보호합니다. 모든 요청의 Authorization 헤더에 Bearer 형식을 사용하여 키를 포함하세요. 구체적으로, Authorization: Bearer YOUR_API_KEY로 설정하세요.

예를 들어, curl 명령어는 다음과 같습니다:

curl -X POST https://api.ltx.video/v1/text-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A serene mountain landscape at dawn", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}'

Python 구현은 requests 라이브러리를 사용합니다:

import requests
import os

api_key = os.environ.get("LTXV_API_KEY")
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "prompt": "A serene mountain landscape at dawn",
    "model": "ltx-2-pro",
    "duration": 8,
    "resolution": "1920x1080"
}
response = requests.post("https://api.ltx.video/v1/text-to-video", headers=headers, json=payload)
if response.status_code == 200:
    with open("video.mp4", "wb") as f:
        f.write(response.content)

보안 수칙을 성실히 따르세요. 클라이언트 측 코드나 저장소에 키를 노출하지 마세요. 콘솔을 통해 주기적으로 키를 변경하세요. 또한, 이식성을 높이기 위해 환경 변수를 사용하여 저장하세요.

인증에 실패하면 API는 401 Unauthorized로 응답합니다. 응답 본문에는 "Invalid API key" 또는 "Missing authorization header"와 같은 세부 정보가 포함됩니다. 키의 형식과 만료 여부를 확인하여 문제를 해결하세요. 일반적인 해결책으로는 키를 재생성하거나 헤더 구문을 수정하는 것이 있습니다.

LTX-2 API에서 지원되는 모델 이해하기

LTX-2 API는 주로 두 가지 모델인 ltx-2-fast와 ltx-2-pro를 제공합니다. 각 모델은 다른 우선순위에 최적화되어 있습니다.

ltx-2-fast 모델은 효율성을 우선시합니다. 이 모델은 특정 구성에서 최대 3840x2160 해상도, 25 또는 50 FPS, 그리고 6초에서 20초까지의 길이를 지원합니다. 예를 들어, 1920x1080 해상도 및 25 FPS에서는 최대 20초를 처리합니다. 이 모델은 완벽함보다 속도가 중요한 빠른 프로토타입 제작에 적합합니다.

반대로, ltx-2-pro 모델은 품질을 강조합니다. 이 모델은 길이를 6, 8, 10초로 제한하지만, 우수한 디테일과 일관성을 제공합니다. 또한, 최대 3840x2160 해상도와 25 또는 50 FPS를 지원합니다. 개발자들은 정교함이 필요한 최종 결과물에 이 모델을 선택합니다.

정확한 조합은 다음 모델 지원 매트릭스를 참조하세요:

모델	해상도	FPS	길이 (초)
ltx-2-fast	1920x1080	25	6, 8, 10, 12, 14, 16, 18, 20
	1920x1080	50	6, 8, 10
	2560x1440	25, 50	6, 8, 10
	3840x2160	25, 50	6, 8, 10
ltx-2-pro	1920x1080	25, 50	6, 8, 10
	2560x1440	25, 50	6, 8, 10
	3840x2160	25, 50	6, 8, 10

요구 사항에 따라 모델을 선택하세요. 예를 들어, 개발 반복 시에는 ltx-2-fast를 사용하고, 프로덕션에서는 ltx-2-pro로 전환하세요. 해상도와 길이가 높을수록 더 많은 크레딧이 소모된다는 점을 참고하세요.

LTX-2 API의 텍스트-투-비디오 엔드포인트 숙달하기

개발자들은 텍스트-투-비디오 엔드포인트를 호출하여 설명으로부터 비디오를 생성합니다. URL은 https://api.ltx.video/v1/text-to-video이며, POST 메서드를 사용합니다.

필수 매개변수는 다음과 같습니다:

prompt: 문자열, 최대 5000자, 장면을 설명합니다.
model: 열거형, "ltx-2-fast" 또는 "ltx-2-pro" 중 하나입니다.
duration: 정수, 초 단위, 모델 제약 조건에 따릅니다.
resolution: 문자열, "1920x1080"과 같습니다.

선택적 매개변수는 제어를 강화합니다:

fps: 정수, 기본값은 25입니다.
camera_motion: 팬 또는 줌과 같은 효과를 위한 열거형 (여기에 구체적인 값은 자세히 설명되어 있지 않으며, 문서를 참조하세요).
generate_audio: 불리언, 동기화된 오디오의 경우 기본값은 true입니다.

요청은 JSON 콘텐츠를 예상합니다. 성공적인 응답은 본문에 Content-Type: video/mp4와 함께 MP4 파일을 반환합니다.

예를 들어, 8초 길이의 비디오를 생성합니다:

curl -X POST https://api.ltx.video/v1/text-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A majestic eagle soaring through clouds at sunset", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}' \
-o video.mp4

Python 등가 코드는 파일을 직접 저장합니다. 오류가 발생하면 유효하지 않은 매개변수에 대한 400 또는 제한에 대한 429와 같은 코드를 처리하세요.

프롬프트를 실험하여 결과물을 다듬으세요. 더 나은 결과를 위해 액션, 캐릭터, 오디오에 대한 세부 정보를 포함하세요. 이 엔드포인트는 텍스트 기반 비디오 생성의 기반을 이룹니다.

LTX-2 API의 이미지-투-비디오 엔드포인트 탐색하기

이미지-투-비디오 엔드포인트는 정적 이미지를 애니메이션화합니다. https://api.ltx.video/v1/image-to-video로 POST를 사용합니다.

주요 매개변수는 텍스트-투-비디오와 유사하지만 image_uri를 추가합니다: 문자열, 입력 이미지의 URL (HTTPS, 최대 32MB, JPG와 같은 형식).

예시 요청:

curl -X POST https://api.ltx.video/v1/image-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_uri": "https://example.com/sunset.jpg", "prompt": "Clouds drifting across the sky as the sun sets slowly", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}' \
-o video.mp4

응답은 애니메이션된 MP4를 전달합니다. 마케팅 또는 교육 앱에서 사진에 생명을 불어넣는 데 사용하세요. 일관된 움직임을 위해 이미지가 프롬프트와 일치하는지 확인하세요.

제약 조건은 모델과 일치합니다: 길이와 해상도를 검증하세요. 이미지 가져오기에 실패하면 400 오류를 예상하세요.

LTX-2 API의 재촬영(Retake) 기능 활용하기

재촬영 기능은 전체 재성성 없이 비디오 섹션을 편집합니다. AI를 통해 특정 순간을 대상으로 오디오, 비디오 또는 둘 다를 교체합니다.

자세한 엔드포인트 사양은 진화 중이지만, /v1/retake와 같은 경로에 POST를 사용할 가능성이 높습니다. 매개변수에는 원본 비디오의 video_uri, 초 단위의 start_time 및 end_time, 그리고 변경 사항을 위한 prompt가 포함됩니다.

예를 들어, 대화 세그먼트를 다시 작성합니다. 이는 전체 비디오를 다시 만드는 것보다 리소스를 절약합니다. 개발자들은 포스트 프로덕션 워크플로우에서 반복적인 개선을 위해 이를 적용합니다.

전체 매개변수에 대한 문서를 업데이트하는지 모니터링하세요. 현재 이 기능은 동기화를 유지하며 순간을 효율적으로 다시 작성합니다.

LTX-2 API에서 오류 처리하기

API는 오류 응답을 표준화합니다:

{
  "type": "error",
  "error": {
    "type": "error_type",
    "message": "Description"
  }
}

일반적인 코드:

400: 잘못된 요청, 예: 프롬프트 누락.
401: 인증 문제.
402: 크레딧 부족.
413: 페이로드 너무 큼.
422: 콘텐츠 필터링됨.
429: 요청 속도 또는 동시성 제한.
500: 서버 오류.
503: 서비스 이용 불가.

우아하게 처리하기: Retry-After 헤더로 429에 대해 재시도합니다. 402에 대한 잔액을 확인합니다. 디버깅을 위해 메시지를 기록합니다.

모범 사례: 클라이언트 측에서 입력을 검증하고, 재시도를 위해 지수 백오프를 구현합니다.

LTX-2 API에서 요청 속도 제한 관리하기

요청 속도 제한은 남용을 방지합니다. 여기에는 동시성(동시 요청) 및 속도(기간당 요청)가 포함되며, 요금제에 따라 다릅니다.

초과하면 Retry-After와 함께 429가 발생합니다. 오류 유형: rate_limit_error 또는 concurrency_limit_error.

헤더를 통해 모니터링합니다. 가능한 경우 일괄 처리, 테스트를 위한 낮은 해상도 사용, 요금제 업그레이드를 통해 최적화합니다.

증가를 위해 지원팀에 문의하세요.

LTX-2 API 통합을 위한 모범 사례

견고한 오류 처리 및 로깅을 구현합니다. 확장 시 비동기 처리를 사용합니다.

저장소로 키를 보호합니다. 프롬프트를 광범위하게 테스트합니다.

프로덕션의 경우 비용을 계산하세요: 비디오 길이가 길수록 더 많은 크레딧을 사용합니다.

워크플로우와 통합합니다: 이미지에서 썸네일을 생성한 다음 전체 비디오를 생성합니다.

LTX-2 API와 함께 Apidog 사용하기

Apidog는 테스트를 간소화합니다. 엔드포인트를 가져오고, 헤더를 설정하고, 요청을 시각적으로 전송합니다.

LTX-2 API 호출을 위한 컬렉션을 생성합니다. 바이너리 MP4를 포함한 응답을 디버깅합니다.

키에 대한 환경을 지원하여 전환을 용이하게 합니다.

생산성을 높이기 위해 Apidog를 무료로 다운로드하세요.

LTX-2 API의 고급 예제

Python에서 래퍼를 구축합니다:

import requests
import os

class LTX2API:
    def __init__(self):
        self.api_key = os.environ.get("LTXV_API_KEY")
        self.base_url = "https://api.ltx.video/v1"

    def generate_text_to_video(self, prompt, model="ltx-2-pro", duration=8, resolution="1920x1080"):
        headers = {"Authorization": f"Bearer {self.api_key}", "Content-Type": "application/json"}
        payload = {"prompt": prompt, "model": model, "duration": duration, "resolution": resolution}
        response = requests.post(f"{self.base_url}/text-to-video", headers=headers, json=payload)
        if response.status_code == 200:
            return response.content
        else:
            raise Exception(response.json()["error"]["message"])

# Usage
api = LTX2API()
video_data = api.generate_text_to_video("A futuristic cityscape at night")
with open("output.mp4", "wb") as f:
    f.write(video_data)

이미지-투-비디오로 확장합니다. Flask 또는 Django를 통해 웹 앱에서 사용합니다.

결론

LTX-2 API는 비디오 생성을 혁신합니다. 이 가이드를 따르면 개발자들은 그 기능을 효과적으로 활용할 수 있습니다. 기본부터 시작하여 프롬프트를 다듬고 통합을 확장하세요. Apidog와 같은 도구는 프로세스를 단순화하여 원활한 개발을 보장합니다.

버튼