Skip to content

2. Matnni tarjima qilish (Translate)

So'rov manzili

POST /api/v1/translate
Content-Type: application/json

So'rov parametrlari

Parametr Turi Tavsif
text string Tarjima qilinadigan manba matni
source_lang string Manba tili (uz, ru, en). Ko'rsatilmasa → avtomatik aniqlanadi
target_lang string Maqsad tili (uz, ru, en)
blocking boolean true = tugashini kutish, false = identifikator qaytarish
webhook_url string Natija bilan POST so'rov yuboriladigan URL

Cheklovlar

Cheklov Qiymat
Matnning maksimal uzunligi 50 000 so'z
Sinxron (blocking) chegarasi 600 so'z
Avtomatik bo'laklash chegarasi 10 000 so'z

Eslatmalar:

  • Agar matn > 600 so'z bo'lsa → avtomatik ravishda asinxron rejimga o'tadi. blocking=false ishlatib, webhook_url ko'rsating.
  • Agar matn > 50 000 so'z bo'lsa → xatolik qaytariladi (text_too_long).
  • 10 000 so'zdan ortiq matnlar avtomatik ravishda gap chegaralarida bo'laklarga bo'linib, alohida tarjima qilinadi, keyin birlashtiriladi.
  • webhook_url asinxron (non-blocking) vazifalar uchun majburiy.

So'rov namunasi

curl -X POST "https://developer.kotib.ai/api/v1/translate" \
 -H "Authorization: Bearer <api-key>" \
 -H "Content-Type: application/json" \
 -d '{
   "text": "Hello, dunyo!",
   "source_lang": "uz",
   "target_lang": "en",
   "blocking": false
}'

Javob namunasi (blocking = false)

{
  "status": "processing",
  "id": "tr_987654321",
  "message": "Task accepted. Check status via /get-status."
}

Javob namunasi (blocking = true)

{
  "status": "success",
  "text": "Hello, world!"
}

- ← Nutqni matnga aylantirish | Holatni tekshirish →

Tezkor navigatsiya

- ← Oldingi: Nutqni matnga aylantirish | Keyingi: Holatni tekshirish →

- ← Bosh sahifaga qaytish