개발도구 도구
다양한 AI 비디오 생성 모델을 통합하는 파이썬 클라이언트
letorig/video-generator-client
GitHub이 프로젝트는 Seedance, Kling, MiniMax 등 여러 주요 AI 비디오 생성 모델을 하나의 파이썬 클라이언트로 통합한 도구입니다.
세 줄 요약
- 텍스트 및 이미지 기반의 비디오 생성을 지원하며, 웹 UI와 CLI를 통해 실시간 작업 상태 확인까지 편리하게 이용할 수 있습니다.
- 다양한 최신 모델들을 개별 API 연동 없이 하나의 환경에서 쉽게 테스트하고 비교할 수 있어 활용도가 매우 높습니다.
- 다만, 각 제공업체의 API 및 모델 ID는 독립적으로 변경될 수 있으므로 주기적인 업데이트가 필요합니다.
본 프로젝트는 Seedance, Kling, MiniMax/Hailuo, Wan 등 여러 주요 AI 비디오 생성 제공업체들을 하나의 비동기 Python 클라이언트로 통합했습니다. 이 클라이언트는 각 제공업체의 다양한 버전(예: Seedance 2.5, Kling 3.0 Omni)과 모델 ID를 지원하며, 텍스트-비디오(T2V) 및 이미지-비디오(I2V) 입력을 통해 비디오 생성을 수행할 수 있습니다.
사용을 시작하려면 먼저 `git clone` 명령어를 사용하여 클라이언트를 다운로드하고 가상 환경을 설정해야 합니다. 이후 `.env.example` 파일을 복사하여 사용하려는 각 제공업체의 인증 정보를 추가한 후, `pip install -e .[web]` 명령어로 패키지를 설치합니다.
클라이언트에는 CLI와 웹 인터페이스가 모두 포함되어 있습니다. CLI를 통해 비디오 생성(`video-gen generate wan...`) 및 작업 상태 확인(`video-gen status wan TASK_ID`)이 가능하며, 별도의 프론트엔드 빌드 과정 없이 FastAPI가 HTML과 JSON 엔드포인트를 제공하여 모델 검색, 작업 폴링, MP4 다운로드 등의 기능을 지원합니다.