Async Video Gen Client yordamida bir nechta AI provayderlaridan video yarating

Video Gen Client nima qiladi

Video Gen Client bir nechta video yaratish provayderlari uchun yagona asinxron Python klientini taqdim etadi: ByteDance kompaniyasining Seedance, Kuaishou kompaniyasining Kling, MiniMax/Hailuo va Alibaba kompaniyasining Wan xizmatlari. Alohida provayder integratsiyalari bilan ishlash o‘rniga, mavjud modellarni topish, yaratish vazifalarini yuborish, ularning holatini tekshirish va natijalarni yagona buyruq qatori interfeysi yoki veb-ilova orqali yuklab olish mumkin.

Loyiha provayder API'lari atrofidagi integratsiya kodi sifatida ishlab chiqilgan. Bu API'lar va ularning model identifikatorlari mustaqil ravishda o‘zgarishi mumkinligi sababli, provayder adapterlari vaqt o‘tishi bilan yangilanishi talab qilinishi mumkin.

Qo‘llab-quvvatlanadigan provayderlar va modellar

Klient hozirda quyidagi provayder oilalari va API model identifikatorlarini ko‘rsatadi:

• Seedance: 2.5-versiya doubao-seedance-2.5 dan foydalanadi; 2.0-versiya doubao-seedance-2-0-260128 dan foydalanadi; 2.0 Mini va 2.0 Fast darajalari doubao-seedance-2-0-mini-260615 hamda doubao-seedance-2-0-fast-260128 dan foydalanadi.
• Kling: Kling 3.0 va 3.0 Omni mos ravishda kling-v3 va kling-v3-omni dan foydalanadi. Boshqa ko‘rsatilgan modellar qatoriga kling-v2-6, kling-v2-5-turbo va kling-v2-1-master kiradi.
• MiniMax/Hailuo: H3 MiniMax-H3 dan foydalanadi, 2.3-versiya esa MiniMax-Hailuo-2.3 va MiniMax-Hailuo-2.3-Fast dan foydalanadi.
• Wan: Wan 3.0 wan3.0 dan foydalanadi. Wan 2.7, 2.6 va 2.5 matndan videoga, rasmdan videoga, havoladan videoga yoki preview uchun maxsus model identifikatorlarini taqdim etadi.

Klientni o‘rnatish va sozlash

1. Repozitoriyni klonlang:

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

2. Virtual muhit yarating:

   python -m venv .venv

3. Muhitni faollashtiring. Windows tizimida quyidagini bajaring:

   .venv\Scripts\activate

   macOS yoki Linux tizimida esa quyidagini bajaring:

   source .venv/bin/activate

4. Paketni veb-qo‘llab-quvvatlash bilan o‘rnating:

   pip install -e ".[web]"

5. Provayder ma’lumotlarini qo‘shing: .env.example faylini .env fayliga nusxalang, so‘ng foydalanmoqchi bo‘lgan provayderlar uchun ma’lumotlarni qo‘shing. README yagona ma’lumotlar to‘plamini talab qilmaydi, shuning uchun ish jarayonlaringiz uchun zarur bo‘lgan xizmatlargina sozlang.

CLI ishlatilganda yaratilgan natijalar output papkasiga saqlanadi.

Buyruq qatori interfeysidan foydalanish

O‘rnatilgandan so‘ng, video-gen buyrug‘i provayderlarni topish, modellarni tanlash, yaratish vazifalarini boshlash va natijalarni tekshirish uchun asosiy ish jarayonini taqdim etadi.

Provayderlar va modellarni topish

Mavjud buyruqlar va provayderlarni ko‘rishdan boshlang:

video-gen --help
video-gen providers

Provayder modellarini tekshirish uchun uning nomini models buyrug‘iga bering:

video-gen models wan

Video yaratish

Prompt, provayder, model va davomiylikni ko‘rsatib, matndan video yaratish so‘rovini yuboring:

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

Buyruq vazifani tanlangan provayder orqali yuboradi va hosil bo‘lgan natijani output papkasiga saqlaydi. O‘z buyruqlaringizni tuzishda loyiha taqdim etgan provayder va model qiymatlaridan foydalaning, chunki provayderlarda modellar mavjudligi o‘zgarishi mumkin.

Vazifa holatini tekshirish

Asinxron yaratish jarayonlari uchun provayder va vazifa identifikatori orqali vazifani so‘rang:

video-gen status wan TASK_ID

TASK_ID o‘rniga yaratish jarayonida qaytarilgan identifikatorni qo‘ying.

Veb-interfeysni ishga tushirish

Loyiha Python paketining ichida veb-interfeysni ham o‘z ichiga oladi. npm, Node.js yoki alohida frontend build bosqichi mavjud emas. FastAPI HTML interfeysini taqdim etadi hamda provayderlarni topish, video yaratish, vazifalarni kuzatish va MP4 fayllarini yuklab olish uchun JSON endpointlarini ochadi.

Serverni standart host va port bilan ishga tushiring:

video-gen serve

Host va portni aniq ko‘rsatishingiz mumkin:

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

Qayta yuklash yoqilgan server uchun quyidagini ishlating:

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

Veb interfeys imkoniyatlari

Interfeys provayder va model tanlash, matndan videoga va rasmdan videoga kiritishlar, salbiy promptlar, davomiylik, tomonlar nisbati va aniqlik boshqaruvlarini qo‘llab-quvvatlaydi. Shuningdek, u vazifa holatini real vaqt rejimida kuzatish, videoni oldindan ko‘rish, MP4 faylini yuklab olish va joriy server sessiyasi uchun xotirada saqlanadigan vazifalar tarixini taqdim etadi.

Amaliy ish jarayoni bo‘yicha maslahatlar

• Yaratishdan oldin tekshiring: Provayder yoki model tanlashdan oldin video-gen providers va video-gen models PROVIDER buyruqlarini bajaring.
• Ma’lumotlarni cheklangan holda saqlang: Joriy ish jarayoningiz uchun kerak bo‘lgan provayder ma’lumotlarinigina .env fayliga qo‘shing.
• Asinxron vazifalarni kuzating: Yaratish jarayonini status buyrug‘i va veb-interfeysdagi real vaqt kuzatuvi orqali nazorat qilish mumkin.
• Ish jarayoningizga mos interfeysni tanlang: CLI skriptlar va terminaldagi vazifalar uchun qulay, veb-interfeys esa interaktiv boshqaruvlar va oldindan ko‘rishni taqdim etadi.
• Integratsiyani muntazam yangilashga tayyor bo‘ling: Provayder API'lari va model identifikatorlari ushbu SDK'ga bog‘liq emas va o‘zgarishi mumkin. Shu sababli provayder xizmatini yangilaganida adapterlar va modellar katalogini tekshiring.

Loyiha tuzilmasi

Repozitoriy klient, buyruq qatori interfeysi, veb-server, modellar katalogi, provayder adapterlari, statik veb-aktivlar, misollar, testlar va yordamchi kodni alohida qismlarga ajratadi:

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

Konfiguratsiya .env.example orqali ifodalanadi, paketlash va o‘rnatish sozlamalari esa pyproject.toml da belgilangan. Repozitoriyda shuningdek examples/, tests/ va ixtiyoriy mcp_server/ kataloglari mavjud.

Xulosa

Video Gen Client Python dasturchilariga bir nechta video yaratish provayderlari bilan yagona usulda ishlash imkonini beradi. Uni virtual muhitga o‘rnating, kerakli hisob ma’lumotlarini sozlang, qo‘llab-quvvatlanadigan modellarni aniqlang va vazifalarni CLI yoki to‘plam bilan birga keladigan FastAPI veb-interfeysi orqali yuboring. Ishlab chiqarish muhitida provayderlardagi o‘zgarishlarni kuzatib boring, chunki model identifikatorlari va API xatti-harakati mijozdan mustaqil ravishda o‘zgarishi mumkin.