← Back
letorig

letorig/video-generator-client

Async Python wrapper for Seedance, Kling, MiniMax and Wan video generation. Supports CLI and a local web UI

View on GitHub ↗
klingkling-aiminimax-h3seedanceseedance-2-5video-generationvideo-generation-apivideo-generation-tool
Stars
551
Forks
87
Watchers
551
Open issues
2
Contributors
1
Language
Python
License
MIT License
Default branch
main
Created Sep 14, 2026Updated Sep 26, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Video Gen Client

One async Python client for multiple video-generation providers: Seedance, Kling, MiniMax/Hailuo and Wan.

Supported Models

Supported Models

Provider Version API Model ID Notes
Seedance (ByteDance) 2.5 doubao-seedance-2.5 30s one-take, native audio
Seedance 2.0 doubao-seedance-2-0-260128 Full 2.0, multimodal input
Seedance 2.0 Mini doubao-seedance-2-0-mini-260615 Budget tier, 480p/720p, 4–15s
Seedance 2.0 Fast doubao-seedance-2-0-fast-260128 Faster 2.0, lower quality
Kling (Kuaishou) 3.0 / 3.0 Omni kling-v3 / kling-v3-omni Flagship, multi-shot, native audio
Kling 2.6 kling-v2-6 First with synced audio + video
Kling 2.5 Turbo kling-v2-5-turbo 1080p, cheap for high volume
Kling 2.1 kling-v2-1-master Cinematic control, better semantics
MiniMax / Hailuo H3 MiniMax-H3 4K, 60fps, 30s, native audio
MiniMax 2.3 MiniMax-Hailuo-2.3 1080p, T2V + I2V
MiniMax 2.3 Fast MiniMax-Hailuo-2.3-Fast Faster 2.3, I2V only
Wan (Alibaba) 3.0 wan3.0 All-in-one, 30s, up to 1080p
Wan 2.7 wan2.7-t2v / wan2.7-i2v / wan2.7-r2v Specialized models
Wan 2.6 wan2.6-t2v / wan2.6-i2v Multi-shot, longer clips
Wan 2.5 wan2.5-t2v-preview 1080p, audio support

Install

git clone https://github.com/letorig/video-generator-client
cd video-generator-client
python -m venv .venv
# Windows:
.venv\\Scripts\\activate
# macOS/Linux:
source .venv/bin/activate
pip install -e ".[web]"

Copy .env.example to .env and add the credentials for the providers you use.

CLI

Output is saved to the output folder.

video-gen --help
video-gen providers
video-gen models wan
video-gen generate wan --prompt "A snowy forest at dawn" --model 2.1 --duration 5
video-gen status wan TASK_ID
video-gen serve

Web server options:

video-gen serve --host 127.0.0.1 --port 8000
video-gen serve --host 0.0.0.0 --port 9000 --reload

Web UI

The web interface is bundled directly into the Python package; there is no npm, Node.js or frontend build step. FastAPI serves the HTML and exposes JSON endpoints for provider discovery, generation, task polling and MP4 download.

The UI provides:

  • provider/model selection
  • text-to-video and image-to-video input
  • negative prompt
  • duration, aspect ratio and resolution
  • live task status polling
  • video preview and MP4 download
  • in-memory task history for the current server session

Project layout

unified-video-gen/
├── src/video_gen/
│   ├── client.py
│   ├── cli.py
│   ├── web.py
│   ├── catalog.py
│   ├── static/index.html
│   ├── providers/
│   └── utils/
├── examples/
├── tests/
├── mcp_server/
├── .env.example
├── .gitignore
├── LICENSE
└── pyproject.toml

Important

Provider APIs and model IDs change independently of this SDK. Treat the provider adapters as integration code that may need updates when a provider changes its API.

License

MIT.