REST API / V1

Dublajni o‘z
jarayoningizga ulang.

Avtomatik ishga tushiring yoki tarjimani tahrir qilib, o‘sha loyiha ID’si orqali davom ettiring.

Autentifikatsiya

Tarif sotib olgach, kabinetda API kaliti yarating. Kalit faqat bir marta ko‘rsatiladi; uni serveringizdagi .env faylida saqlang. Frontend, URL, Git yoki loglarga qo‘ymang.

DUBLAJ_API_URL=https://your-domain.example
DUBLAJ_API_KEY=dubl_your_secret_key

Barcha v1 so‘rovlari Authorization: Bearer … bilan yuboriladi. API kaliti boshqaruv API’lariga kira olmaydi. Kabinetda bekor qilish darhol amal qiladi.

Avtomatik dublaj

curl "$DUBLAJ_API_URL/api/v1/dubs" \
  -H "Authorization: Bearer $DUBLAJ_API_KEY" \
  -F "file=@video.mp4" -F "mode=automatic" \
  -F "source_language=auto" -F "target_language=uz"

// 202 Accepted
{"job_id":"32_hex_characters","mode":"automatic",
 "status_url":"/api/v1/dubs/32_hex_characters"}

Ixtiyoriy custom_voice_id o‘zingizga tegishli yoki umumiy tasdiqlangan profilni tanlaydi. Audio/video fayl chegarasi 8 GB. ID’ni saqlang. Noaniq POST javobini avtomatik takrorlamang; kabinetdagi loyihalar ro‘yxatini tekshiring.

Holat va natija

curl "$DUBLAJ_API_URL/api/v1/dubs/JOB_ID" \
  -H "Authorization: Bearer $DUBLAJ_API_KEY"

// state.status: running | completed | failed | interrupted
// result faqat yakuniy dublaj tayyor bo‘lganda beriladi.

curl "$DUBLAJ_API_URL/api/v1/dubs/JOB_ID/result/video" \
  -H "Authorization: Bearer $DUBLAJ_API_KEY" -o dubbed.mp4

Holatni 2–5 soniyada tekshiring. Audio uchun result/audio ishlatiladi. Natija tayyor bo‘lmaguncha 404 qaytadi.

Manual: tahrirlang va ID bilan davom eting

Yaratishda mode=manual yuboring. Transkripsiya va tarjima tayyorlangach, state.status=completed, result=null bo‘ladi. Bu hali yakuniy audio emas; segmentlarni tekshiring.

curl -X PUT "$DUBLAJ_API_URL/api/v1/dubs/JOB_ID/script" \
  -H "Authorization: Bearer $DUBLAJ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"glossary":"Acme nomi o‘zgarmasin","segments":[
    {"id":"line_1","start":0,"end":2.5,"speaker":"speaker_0",
     "text":"Hello, world.","translation":"Salom, dunyo."}]}'

curl -X POST "$DUBLAJ_API_URL/api/v1/dubs/JOB_ID/resume" \
  -H "Authorization: Bearer $DUBLAJ_API_KEY"

PUT barcha segmentlarni almashtiradi. ID’lar yagona; vaqtlar media davomiyligi ichida va end>start bo‘lsin. Tarjima 1–1500 belgi. Ishlayotgan vazifani o‘zgartirish 409 bilan rad etiladi. Xatolik/restartdan keyin shu ID orqali davom eting; provider prediction ID’lari qayta ishlatiladi.

Ovoz API’si

GET /api/v1/voices
POST /api/v1/voices  (multipart: file, name)

Shaxsiy ovoz kamida 30 soniya va maksimal 200 MB. Tarifda custom voice huquqi kerak. Ovoz faqat egasi va vakolatli xodimlarga ochiq.

KTS hisobi

KTS = media sekundlari / tarifdagi seconds_per_kts, 0.0001 KTS gacha yuqoriga yaxlitlanadi. 1 sekund/KTS tarifda 10 KTS = 10 sekund. Sotib olingan tarif shartlari saqlanadi; keyingi tarif tahriri oldingi xaridni o‘zgartirmaydi.

Jarayon boshida KTS band qilinadi. Manual tahlil shu bandni yakuniy dublajgacha saqlaydi. Xatolikda bir marta qaytariladi. Restartdan davom etishda KTS yana olinmaydi. Tugagan loyihani qayta dublaj qilish yangi ish. Preview segment davomiyligi bo‘yicha hisoblanadi.

KodMa’no
401Kalit/session yaroqsiz
402Tarif yoki KTS yetarli emas
403Rol/ovoz huquqi yetarli emas
404Resurs sizniki emas yoki tayyor emas
409Vazifa ishlamoqda yoki holati mos emas
422Parametr/media noto‘g‘ri
429Kirish urinishlari limiti
502/503Provider/server konfiguratsiyasi tayyor emas

Xato shakli: {"detail":"…"}. Boshqa mijoz loyihasiga kirish taqiqlangan.

Serverni sozlash

.\scripts\setup_runtime.ps1
.\.venv-runtime\Scripts\python.exe scripts/setup_voice_db.py
.\.venv-runtime\Scripts\python.exe scripts/configure_platform.py
# .env ichidagi yangi sozlamalarni tekshiring.
.\.venv-runtime\Scripts\python.exe scripts/setup_platform.py --demo-tariffs
.\start.ps1

configure_platform.py mavjud kalitlarni saqlaydi. Birinchi admin .envdagi BOOTSTRAP_ADMIN_EMAIL, BOOTSTRAP_ADMIN_PASSWORD orqali yaratiladi. Script qayta bajarilganda parol o‘zgarmaydi. Xodimlar /staff/login, mijozlar /login orqali kiradi.

Google va Telegram

Google: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, callback APP_URL/api/auth/google/callback. Bir martalik state va PKCE ishlaydi. Email/parol hisobi Google emaili tengligi bilan avtomatik birlashtirilmaydi.

Telegram: TELEGRAM_BOT_USERNAME, TELEGRAM_BOT_TOKEN, BotFather’da to‘g‘ri domen. Imzo, auth_date va replay serverda tekshiriladi. Kalitlar bo‘lmasa email registratsiyasi ishlaydi.

To‘lovlar

Mahalliy test: BILLING_MODE=test, BILLING_TEST_SIMULATOR=true. Haqiqiy pul yechilmaydi. Simulator APP_ENV=productionda ishlamaydi. Stripe sandbox: STRIPE_SECRET_KEY=sk_test_…, STRIPE_WEBHOOK_SECRET, webhook APP_URL/api/billing/webhooks/stripe. Visa va mos qurilmada Apple Pay/Google Pay hosted Checkout’da ishlaydi.

Kripto: NOWPAYMENTS_API_KEY, NOWPAYMENTS_IPN_SECRET, sandbox/live NOWPAYMENTS_API_BASE, IPN APP_URL/api/billing/webhooks/nowpayments. Qisman to‘lov to‘liq KTS bermaydi. Balans faqat imzo, ID, miqdor va valyuta tekshirilgan webhookdan so‘ng yangilanadi. Success URL balansni o‘zgartirmaydi.

Production: HTTPS, aniq APP_URL, kuchli admin parol, PostgreSQL/data zaxiralari va doimiy xizmat jarayoni kerak. Test bypass o‘zgaruvchilarini qo‘ymang. Maxfiy kalitlar .envda; tarif, kontent, balans va boshqariladigan sozlamalar PostgreSQL’da saqlanadi.

PageSpeed

Landing lokal CSS/JS, tizim shriftlari, kechiktirilgan skriptlar, transform/opacity animatsiyalari va reduced motion’dan foydalanadi. Google PageSpeed’dagi 85+ natijani production URL’i bilan mobil va desktop’da o‘lchash kerak; lokal tekshiruv bu ballni kafolatlamaydi.

Rasmiy manbalar: Stripe Checkout, Stripe webhook, Google OAuth, Telegram login, NOWPayments.