Lavhalar API — dasturchilar uchun

Lavhalar API orqali o'z ilovangiz, botingiz yoki saytingizdan rasm va video yaratishingiz mumkin. Har bir so'rov kabinetingizdagi kreditlardan yechiladi; generatsiya muvaffaqiyatsiz bo'lsa — kredit avtomatik qaytariladi.

1. Kalit olish

Kabinet → «API kalitlar» → «Yangi kalit». Kalit faqat bir marta ko'rsatiladi. Har bir so'rovda sarlavha yuboring:

Authorization: Bearer lv_XXXXXXXXXXXXXXXX

2. Ishlash tartibi

Generatsiya asinxron: POST so'rov darhol 202 va vazifa (id, status) qaytaradi. So'ng GET /v1/jobs/{id} orqali holatni har 3–5 soniyada tekshiring: queued → running → done | failed.

3. Rasm yaratish — POST /v1/images

curl -X POST https://lavhalar.uz/v1/images \
  -H "Authorization: Bearer $LAVHALAR_KEY" -H "Content-Type: application/json" \
  -d '{"model":"flux-schnell","prompt":"Samarqand Registoni, oqshom, kinematik","aspect_ratio":"16:9","count":2,"translate":true}'

Maydon	Tavsif
model	Model identifikatori (GET /v1/models)
prompt	Tavsif (o'zbek, rus yoki ingliz tilida)
aspect_ratio	1:1, 4:5, 3:4, 9:16, 16:9, 4:3 (modelga bog'liq)
count	1–4 ta rasm
seed	Takrorlanuvchanlik uchun butun son
reference_images	Namuna rasmlar: https://… yoki data:image/png;base64,… (≤4)
character_id	Saqlangan personaj ID si
translate	true — promptni inglizchaga o'girish (LLM ulangan bo'lsa)

4. Video yaratish — POST /v1/videos

curl -X POST https://lavhalar.uz/v1/videos \
  -H "Authorization: Bearer $LAVHALAR_KEY" -H "Content-Type: application/json" \
  -d '{"model":"kling-25","prompt":"Choyxonada choy quyilmoqda","duration":5,"aspect_ratio":"9:16","preset":"sekin-yaqinlashish"}'

image maydoni berilsa — rasmdan video rejimi. preset — kamera harakati yoki effekt (ro'yxat pastda). ai_label (standart true) videoga ko'rinadigan «AI» belgisini qo'yadi; metama'lumotdagi AI belgisi har doim qo'yiladi.

5. Holatni olish — GET /v1/jobs/{id}

{
  "id": "3f9c…", "status": "done", "cost": 2, "model": "flux-schnell",
  "outputs": [{"id": "a1b2…", "type": "image", "url": "https://lavhalar.uz/media/…jpg", "width": 1024, "height": 576}]
}

6. Xatolar

Kod	Ma'nosi
401	Kalit yo'q yoki noto'g'ri
402	Kredit yetarli emas
422	Moderatsiya: so'rov qoidalarga zid
503	Model provayderi ulanmagan

7. Modellar

8. Kamera harakatlari va effektlar

Foydalanish shartlari API uchun ham amal qiladi. Natijalarni AI ekanini yashirib tarqatish taqiqlanadi.