Khiqiza Amavidiyo Kubahlinzeki Be-AI Abaningi usebenzisa i-Async Video Gen Client

Okwenziwa i-Video Gen Client

I-Video Gen Client ihlinzeka ngeklayenti elilodwa le-async Python labahlinzeki abaningana bokukhiqiza amavidiyo: i-Seedance yakwa-ByteDance, i-Kling yakwa-Kuaishou, i-MiniMax/Hailuo, kanye ne-Wan yakwa-Alibaba. Esikhundleni sokusebenza nama-integration ahlukene omhlinzeki ngamunye, ungathola amamodeli atholakalayo, uthumele imisebenzi yokukhiqiza, uhlole isimo sayo, futhi ulande imiphumela usebenzisa isikhombimsebenzisi esihlanganisiwe somugqa womyalo noma uhlelo lwewebhu.

Le phrojekthi yakhelwe njengekhodi yokuhlanganisa ezungeze ama-API abahlinzeki. Ngenxa yokuthi lawo ma-API nama-ID amamodeli awo angashintsha ngokuzimela, ama-adapter abahlinzeki angase adinge ukubuyekezwa ngokuhamba kwesikhathi.

Abahlinzeki Namamodeli Asekelwayo

Okwamanje iklayenti libala imindeni yabahlinzeki nama-ID amamodeli e-API alandelayo:

• Seedance: inguqulo 2.5 isebenzisa doubao-seedance-2.5; inguqulo 2.0 isebenzisa doubao-seedance-2-0-260128; amazinga e-2.0 Mini nawe-2.0 Fast asebenzisa doubao-seedance-2-0-mini-260615 kanye ne-doubao-seedance-2-0-fast-260128.
• Kling: i-Kling 3.0 ne-3.0 Omni zisebenzisa kling-v3 kanye ne-kling-v3-omni. Amanye amamodeli abalwe afaka phakathi kling-v2-6, kling-v2-5-turbo, kanye ne-kling-v2-1-master.
• MiniMax/Hailuo: i-H3 isebenzisa MiniMax-H3, kanti inguqulo 2.3 isebenzisa MiniMax-Hailuo-2.3 kanye ne-MiniMax-Hailuo-2.3-Fast.
• Wan: i-Wan 3.0 isebenzisa wan3.0. I-Wan 2.7, 2.6, kanye ne-2.5 inikeza ama-ID amamodeli akhethekile wombhalo kuya kuvidiyo, isithombe kuya kuvidiyo, i-reference kuya kuvidiyo, noma okubuka kuqala.

Faka Futhi Lungiselela Iklayenti

1. Clone-a i-repository:

   git clone https://github.com/letorig/video-generator-client
   cd video-generator-client

2. Dala indawo ebonakalayo:

   python -m venv .venv

3. Yenza indawo isebenze. Ku-Windows, sebenzisa:

   .venv\Scripts\activate

   Ku-macOS noma ku-Linux, sebenzisa:

   source .venv/bin/activate

4. Faka iphakheji ngokusekelwa kwewebhu:

   pip install -e ".[web]"

5. Engeza imininingwane yokungena yabahlinzeki: Kopisha .env.example uye ku-.env, bese wengeza imininingwane yokungena yabahlinzeki ohlela ukubasebenzisa. I-README ayibeki iqoqo elilodwa elidingekayo lemininingwane yokungena, ngakho lungiselela kuphela amasevisi adingwa yizinqubo zakho.

Okukhiqiziwe kugcinwa kufolda ye-output uma usebenzisa i-CLI.

Sebenzisa Isikhombimsebenzisi Somugqa Womyalo

Ngemva kokufakwa, umyalo we-video-gen uhlinzeka ngenqubo eyinhloko yokuthola abahlinzeki, ukukhetha amamodeli, ukuqala imisebenzi yokukhiqiza, nokuhlola imiphumela.

Thola Abahlinzeki Namamodeli

Qala ngokubuka imiyalo nabahlinzeki abatholakalayo:

video-gen --help
video-gen providers

Ukuhlola amamodeli omhlinzeki, dlulisela igama lomhlinzeki kumyalo we-models:

video-gen models wan

Khiqiza Ividiyo

Thumela isicelo sombhalo kuya kuvidiyo esine-prompt, umhlinzeki, imodeli, nobude besikhathi:

video-gen generate wan --prompt "A snowy forest at dawn" --model 2.1 --duration 5

Umyalo uthumela umsebenzi ngomhlinzeki okhethiwe bese ugcina umphumela okhiqiziwe kufolda ye-output. Sebenzisa amanani omhlinzeki nemodeli avezwa yiphrojekthi lapho wakha eyakho imiyalo, ngoba ukutholakala kwamamodeli abahlinzeki kungashintsha.

Hlola Isimo Somsebenzi

Ezinqubweni zokukhiqiza ezingavumelanisiwe, buza umsebenzi usebenzisa umhlinzeki ne-ID yomsebenzi:

video-gen status wan TASK_ID

Faka esikhundleni se-TASK_ID isihlonzi esibuyiswe yinqubo yokukhiqiza.

Qalisa Isixhumi Esibonakalayo Sewebhu

Iphrojekthi ihlanganisa isixhumi esibonakalayo sewebhu ngqo kwiphakheji ye-Python. Ayikho i-npm, i-Node.js, noma inqubo ehlukile yokwakha i-frontend. I-FastAPI isebenzisa i-HTML interface futhi iveze ama-endpoint e-JSON okuthola abahlinzeki, ukukhiqiza amavidiyo, ukuhlola imisebenzi, nokulanda ama-MP4.

Qalisa iseva nge-host ne-port ezenzakalelayo:

video-gen serve

Ungacacisa i-host ne-port ngokusobala:

video-gen serve --host 127.0.0.1 --port 8000

Ukuze usebenzise iseva enokuvuselela okuzenzakalelayo, sebenzisa:

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

Amakhono E-Web UI

Isixhumi esibonakalayo sisekela ukukhethwa komhlinzeki nemodeli, okokufaka kombhalo kuya kuvidiyo nesithombe kuya kuvidiyo, ama-prompt angafanele, ubude besikhathi, isilinganiso sobubanzi nobude, kanye nezilawuli zokulungiswa. Siphinde sinikeze ukuhlolwa bukhoma kwesimo somsebenzi, ukubuka kuqala ividiyo, ukulanda i-MP4, kanye nomlando wemisebenzi ogcinwa enkumbulweni phakathi neseshini yamanje yeseva.

Amathiphu Enqubo Asebenzayo

• Hlola ngaphambi kokukhiqiza: Qalisa video-gen providers kanye ne-video-gen models PROVIDER ngaphambi kokukhetha umhlinzeki noma imodeli.
• Gcina imininingwane yokungena inomkhawulo: Faka kuphela imininingwane yabahlinzeki edingekayo enqubweni yakho yamanje kufayela le-.env.
• Sebenzisa ukulandelela imisebenzi engavumelanisiwe: Ukukhiqiza kungaqashwa ngomyalo we-status nangokuhlolwa bukhoma kwesixhumi esibonakalayo sewebhu.
• Khetha isixhumi esibonakalayo esifanele inqubo yakho: I-CLI ilungele ama-script nemisebenzi esekelwe kutheminali, kanti i-Web UI inikeza izilawuli ezisebenzisanayo nokubuka kuqala.
• Lindela ukulungiswa kokuhlanganisa: Ama-API abahlinzeki nama-ID amamodeli azimele kule SDK futhi angashintsha, ngakho qinisekisa ama-adapter namakhathalogi amamodeli lapho umhlinzeki ebuyekeza isevisi yakhe.

Isakhiwo Sephrojekthi

I-repository ihlukanisa iklayenti, isikhombimsebenzisi somugqa womyalo, iseva yewebhu, ikhathalogi yamamodeli, ama-adapter abahlinzeki, amafayela ewebhu amile, izibonelo, izivivinyo, kanye nekhodi yezinsiza:

src/video_gen/
├── client.py
├── cli.py
├── web.py
├── catalog.py
├── static/index.html
├── providers/
└── utils/

Ukucushwa kumelwe yi-.env.example, kanti izilungiselelo zokupakisha nokufaka zichazwe ku-pyproject.toml. Indawo yokugcina ikhodi iqukethe futhi i-examples/, i-tests/, kanye nohlu lwemibhalo oluyinketho lwe-mcp_server/.

Isiphetho

IVideo Gen Client inikeza onjiniyela bePython indlela ehlanganisiwe yokusebenza nabahlinzeki abaningi bokukhiqiza amavidiyo. Yifake endaweni ebonakalayo, lungisa imininingwane edingekayo yokuqinisekisa, thola amamodeli asekelwayo, bese uthumela imisebenzi usebenzisa i-CLI noma i-FastAPI web UI ehlanganisiwe. Ekusetshenzisweni kokukhiqiza, qapha izinguquko zabahlinzeki ngoba ama-ID amamodeli nokuziphatha kwama-API kungashintsha ngokuzimela kweklayenti.