
Kile Video Gen Client Hufanya
Video Gen Client hutoa mteja mmoja wa Python wa async kwa watoa huduma kadhaa wa utengenezaji wa video: Seedance kutoka ByteDance, Kling kutoka Kuaishou, MiniMax/Hailuo, na Wan kutoka Alibaba. Badala ya kufanya kazi na miunganisho tofauti ya watoa huduma, unaweza kugundua miundo inayopatikana, kutuma kazi za utengenezaji, kuangalia hali yake, na kupakua matokeo kupitia kiolesura cha mstari wa amri kilichounganishwa au programu ya wavuti.
Mradi huu umeundwa kama msimbo wa muunganisho unaozunguka API za watoa huduma. Kwa kuwa API hizo na vitambulisho vya miundo yao vinaweza kubadilika kwa kujitegemea, adapta za watoa huduma zinaweza kuhitaji masasisho baada ya muda.
Watoa Huduma na Miundo Inayoungwa Mkono
Mteja kwa sasa anaorodhesha familia zifuatazo za watoa huduma na vitambulisho vya miundo ya API:
- Seedance: toleo la 2.5 linatumia
doubao-seedance-2.5; toleo la 2.0 linatumiadoubao-seedance-2-0-260128; viwango vya 2.0 Mini na 2.0 Fast vinatumiadoubao-seedance-2-0-mini-260615nadoubao-seedance-2-0-fast-260128. - Kling: Kling 3.0 na 3.0 Omni zinatumia
kling-v3nakling-v3-omni. Miundo mingine iliyoorodheshwa ni pamoja nakling-v2-6,kling-v2-5-turbo, nakling-v2-1-master. - MiniMax/Hailuo: H3 inatumia
MiniMax-H3, huku toleo la 2.3 likitumiaMiniMax-Hailuo-2.3naMiniMax-Hailuo-2.3-Fast. - Wan: Wan 3.0 inatumia
wan3.0. Wan 2.7, 2.6, na 2.5 zinatoa vitambulisho maalum vya miundo ya maandishi-hadi-video, picha-hadi-video, rejeleo-hadi-video, au hakiki.
Sakinisha na Sanidi Mteja
- Fanya kloni ya hifadhi:
git clone https://github.com/letorig/video-generator-client cd video-generator-client - Unda mazingira pepe:
python -m venv .venv - Washa mazingira. Kwenye Windows, endesha:
Kwenye macOS au Linux, endesha:.venv\Scripts\activatesource .venv/bin/activate - Sakinisha kifurushi chenye usaidizi wa wavuti:
pip install -e ".[web]" - Ongeza vitambulisho vya mtoa huduma: Nakili
.env.examplekuwa.env, kisha ongeza vitambulisho vya watoa huduma unaopanga kutumia. README haiagizi seti moja maalum ya vitambulisho, kwa hivyo sanidi huduma zinazohitajika tu kwa mtiririko wako wa kazi.
Matokeo yaliyotengenezwa huhifadhiwa kwenye folda ya output unapotumia CLI.
Tumia Kiolesura cha Mstari wa Amri
Baada ya usakinishaji, amri ya video-gen hutoa mtiririko mkuu wa kugundua watoa huduma, kuchagua miundo, kuanzisha kazi za utengenezaji, na kuangalia matokeo.
Gundua Watoa Huduma na Miundo
Anza kwa kuonyesha amri na watoa huduma wanaopatikana:
video-gen --help
video-gen providersIli kukagua miundo ya mtoa huduma, pitisha jina la mtoa huduma kwenye amri ya models:
video-gen models wanTengeneza Video
Tuma ombi la maandishi-hadi-video lenye kidokezo, mtoa huduma, muundo, na muda:
video-gen generate wan --prompt "A snowy forest at dawn" --model 2.1 --duration 5Amri hutuma kazi kupitia mtoa huduma aliyechaguliwa na kuhifadhi matokeo kwenye folda ya output. Tumia thamani za mtoa huduma na muundo zinazoonyeshwa na mradi unapounda amri zako, kwa kuwa upatikanaji wa miundo ya mtoa huduma unaweza kubadilika.
Angalia Hali ya Kazi
Kwa mitiririko ya kazi ya utengenezaji wa async, ulizia kazi kwa kutumia mtoa huduma na kitambulisho cha kazi:
video-gen status wan TASK_IDBadilisha TASK_ID kwa kitambulisho kilichorejeshwa na mtiririko wa utengenezaji.
Endesha Kiolesura cha Wavuti
Mradi huu unajumuisha kiolesura cha wavuti moja kwa moja kwenye kifurushi cha Python. Hakuna npm, Node.js, au hatua tofauti ya kuunda frontend. FastAPI huhudumia kiolesura cha HTML na kutoa endpoints za JSON za kugundua watoa huduma, kutengeneza video, kufuatilia kazi, na kupakua MP4.
Anzisha seva kwa hosti na porti chaguomsingi:
video-gen serveUnaweza kubainisha hosti na porti wazi:
video-gen serve --host 127.0.0.1 --port 8000Kwa seva yenye uanzishaji upya uliowashwa, tumia:
video-gen serve --host 0.0.0.0 --port 9000 --reloadUwezo wa UI ya Wavuti
Kiolesura kinaunga mkono uteuzi wa watoa huduma na miundo, pembejeo za maandishi-hadi-video na picha-hadi-video, vidokezo hasi, muda, uwiano wa kipimo, na vidhibiti vya mwonekano. Pia hutoa ufuatiliaji wa moja kwa moja wa hali ya kazi, hakiki ya video, upakuaji wa MP4, na historia ya kazi iliyo kwenye kumbukumbu kwa kipindi cha sasa cha seva.
Vidokezo vya Mtiririko wa Kazi
- Kagua kabla ya kutengeneza: Endesha
video-gen providersnavideo-gen models PROVIDERkabla ya kuchagua mtoa huduma au muundo. - Weka vitambulisho kwa upeo unaohitajika: Ongeza tu vitambulisho vya mtoa huduma vinavyohitajika kwa mtiririko wako wa sasa wa kazi kwenye faili la
.env. - Tumia ufuatiliaji wa kazi za async: Utengenezaji unaweza kufuatiliwa kwa amri ya
statusna ufuatiliaji wa moja kwa moja wa kiolesura cha wavuti. - Chagua kiolesura kinacholingana na mtiririko wako wa kazi: CLI ni rahisi kwa hati na kazi za kwenye terminal, huku UI ya wavuti ikitoa vidhibiti shirikishi na hakiki.
- Tarajia matengenezo ya muunganisho: API za watoa huduma na vitambulisho vya miundo hazitegemei SDK hii na zinaweza kubadilika, kwa hivyo thibitisha adapta na katalogi za miundo mtoa huduma anaposasisha huduma yake.
Muundo wa Mradi
Hifadhi inatenganisha mteja, kiolesura cha mstari wa amri, seva ya wavuti, katalogi ya miundo, adapta za watoa huduma, vipengee tuli vya wavuti, mifano, majaribio, na msimbo wa matumizi:
src/video_gen/
├── client.py
├── cli.py
├── web.py
├── catalog.py
├── static/index.html
├── providers/
└── utils/Usanidi unawakilishwa na .env.example, huku mipangilio ya ufungashaji na usakinishaji ikifafanuliwa katika pyproject.toml. Hazina pia ina examples/, tests/, na saraka ya hiari ya mcp_server/.
Hitimisho
Video Gen Client huwapa wasanidi wa Python njia iliyounganishwa ya kufanya kazi na watoa huduma wengi wa uundaji wa video. Isakinishe katika mazingira pepe, sanidi vitambulisho vinavyohitajika, gundua miundo inayotumika, na wasilisha kazi kupitia CLI au kiolesura cha wavuti cha FastAPI kilichojumuishwa. Kwa matumizi ya uzalishaji, fuatilia mabadiliko ya watoa huduma kwa sababu vitambulisho vya miundo na mienendo ya API vinaweza kubadilika kwa kujitegemea na mteja.
