🛰️ Kadastr AI — API hujjatlari

Andijon viloyati Davlat Kadastrlari Palatasi — sun'iy intellekt xizmatlari (v2)

Bazaviy manzil: https://andkadastrai.uz/api/v2

1. Boshlash

Kadastr AI v2 API — tashqi ilovalar uchun ochiq interfeys. U info-kioskning barcha imkoniyatlarini masofadan boshqarish imkonini beradi:

⚠️ Har bir so'rov API-kalit talab qiladi (xavfsizlik uchun). Kalit admin paneldan beriladi va istalgan vaqtда o'chirib qo'yilishi mumkin.

2. Autentifikatsiya (API-kalit)

Kalitни ikki usulда yuborish mumkin:

a) HTTP sarlavhasi (tavsiya etiladi)

Authorization: Bearer kad_XXXXXXXXXXXXXXXX

b) URL parametri

?key=kad_XXXXXXXXXXXXXXXX

Kalitni admin: admin.andkadastrai.uz → API kalitlar bo'limidан yaratadi. Kalit bekor qilinса — barcha so'rovlar 401 qaytaradi.

3. Modellar ro'yxati

GET/api/v2/models

O'rnatilgan barcha AI modellarни qaytaradi (LLM, Avatar, STT, Face, TTS).

Misol

curl -H "Authorization: Bearer kad_XXX" \
  https://andkadastrai.uz/api/v2/models

Javob

{ "count": 19, "models": [
  { "n":1, "kategoriya":"LLM", "model":"Ollama qwen2.5:7b-instruct",
    "hajm":"4.7 GB", "turi":"Local", "vazifa":"Savol-javob" }, ... ] }

4. Savol berish (asosiy)

POST/api/v2/ask

Savol yuboradi, matn javob + ovoz + avatar havolalarини qaytaradi.

Tanа (JSON)

MaydonTuriIzoh
questionstringSavol matni (majburiy)
langstringuz / ru / en (ixtiyoriy, default uz)

Misol

curl -X POST https://andkadastrai.uz/api/v2/ask \
  -H "Authorization: Bearer kad_XXX" \
  -H "Content-Type: application/json" \
  -d '{"question":"Andijon viloyati statistikasi","lang":"uz"}'

Javob

{
  "question": "Andijon viloyati statistikasi",
  "lang": "uz",
  "text": "Andijon viloyati bo'yicha jami 296 ta mahalla ...",
  "source": "Kadastr (viloyat)",
  "table": null,
  "voice_url":  "/api/v2/tts?text=...&key=...",
  "avatar_url": "/api/v2/avatar?text=...&key=..."
}

voice_url — ochilса mp3 (ovoz), avatar_url — ochilса mp4 (gapiruvchi avatar).

5. Matn → ovoz (TTS)

GET/api/v2/tts

Matnни o'zbekcha ovozга aylantiradi. Javob: audio/mpeg (mp3).

ParametrIzoh
textMatn (majburiy)
languz / ru / en
voicemadina (ayol) / sardor (erkak)
https://andkadastrai.uz/api/v2/tts?text=Assalomu%20alaykum&lang=uz&key=kad_XXX

6. Matn → gapiruvchi avatar

GET/api/v2/avatar

Matnни gapiruvchi video-avatar (lab-sinx + ovoz) qilib qaytaradi. Javob: video/mp4.

ParametrIzoh
textMatn (majburiy)
languz / ru / en
https://andkadastrai.uz/api/v2/avatar?text=Xush%20kelibsiz&lang=uz&key=kad_XXX

Keshда bo'lsa oniy; yangi matn ~10-60s da yasaladi.

7. Holat

GET/api/v2/health

Kalitsiz. Servis ishlayotganини tekshiradi.

curl https://andkadastrai.uz/api/v2/health
{ "ok": true, "api": "v2", "ts": 1785... }

8. Jonli sinov

Kalit va savolни kiriting →

9. Xato kodlari

KodMa'no
200Muvaffaqiyat
400Noto'g'ri so'rov (masalan question yo'q)
401Kalit yo'q yoki bekor qilingan
404Endpoint topilmadi
502Ichki servis xatosi (TTS/avatar)

Xavfsizlik