Tilvar API

Boshlash uchun

1. Barcha a'zolar bepul daraja bilan API dan foydalana oladi; Qo'llab-quvvatlovchi va Akademiklar yuqori chegaralarga ega. A'zolik darajalari
2. Hisob sahifangizdan API kalitini yarating. Hisobim
3. Kalitni har bir so'rovda Authorization: Bearer … sarlavhasida yuboring.

Kalitingizni hech kim bilan baham ko'rmang: kalitni biluvchi sizning kvotangizdan foydalanishi mumkin. Shubhalansangiz, hisob sahifasidan yangi kalit yarating; eski kalit bekor qilinadi.

Manzil: https://tilvar.athena.org.tr

Matn tarjimasi

POST /api/translate JSON tanasi: text (tarjima qilinadigan matn), tgt (maqsadli til kodi, masalan, tur, eng), ixtiyoriy src (manba til kodi; berilmasa avtomatik aniqlanadi).

curl -s https://tilvar.athena.org.tr/api/translate \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"text": "Hello world", "tgt": "tur"}'

Javob:

{"translation": "Merhaba dünya", "warnings": [], "source_language": "eng"}

warnings ro'yxati, raqamlarning yo'qolishi yoki lug'at qoidasining qo'llanilmasligi kabi ogohlantirishlarni o'z ichiga oladi; bo'sh bo'lsa, muammo kuzatilmagan.

import requests

r = requests.post(
    "https://tilvar.athena.org.tr/api/translate",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"text": "Hello world", "tgt": "tur"},
    timeout=120,
)
r.raise_for_status()
print(r.json()["translation"])

Suhbatga mos keladigan nuqta (brauzer kengaytmalari uchun)

POST /v1/chat/completions Suhbat formatidagi so'rovlarni qabul qiladi; bu nuqta suhbatlashmaydi, tarjima qiladi: model maydoni tilvar-<hedef dil kodu> formatida va oxirgi user xabari o'sha tilga tarjima qilinadi.

curl -s https://tilvar.athena.org.tr/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "tilvar-tur", "messages": [{"role": "user", "content": "Hello world"}]}'

Suhbat

POST /api/chat holatsiz suhbat (tarixni mijoz saqlaydi). messages oxirgi 10 xabarni o'z ichiga oladi, oxirgi user; tgt tarjima so'rovlarining standart maqsad tili; web: true yordamchining zarur bo'lganda internetda qidirishiga ruxsat beradi (so'rov Tor orqali boradi, manbalar javobda qaytadi).

curl -s https://tilvar.athena.org.tr/api/chat \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"messages": [{"role": "user", "content": "What is new in llama.cpp?"}], "tgt": "tur", "web": true}'

Javob:

{"reply": "…", "kind": "chat", "sources": [{"title": "…", "url": "https://…"}]}

Massiv tarjima

POST /api/translate/batch qisqa matnlarni bitta so'rovda tarjima qiladi (sahifa tarjimasi uchun). Maksimal 60 ta element va jami 3.500 belgisi. Server vaqt chegarasiga yetganda to'xtaydi; done nechta element tarjima qilinganini aytadi, qolganlarini qayta yuboring.

curl -s https://tilvar.athena.org.tr/api/translate/batch \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items": ["Hello", "Read more"], "tgt": "tur"}'

Vizual tahlil

POST /api/vision ko'p qismli (multipart) so'rov. Maydonlar:

• image: JPEG, PNG, WebP, GIF yoki BMP, maksimal 8 MB.
• task: describe rasmdagi nima borligini tasvirlaydi; text ichidagi matnni o'qiydi; translate matnni o'qiydi va tgt tiliga tarjima qiladi; ask rasm haqidagi question maydondagi savolga javob beradi.
• tgt: tavsiflash va tarjima qilish uchun maqsadli til kodi (standart tur).

Har bir vizual kunlik API kvotasi 1.000 belgisi hisoblanadi. Vizualar saqlanmaydi.

curl -s https://tilvar.athena.org.tr/api/vision \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F [email protected] -F task=translate -F tgt=eng

Javob (translate):

{"result": "Coffee House - Open: 08:00-22:00", "text": "Kahve Evi — Açık: 08:00-22:00", "translation": "Coffee House - Open: 08:00-22:00", "source_language": "tur"}

Brauzer kengaytmasi

Tilvar kengaytmasi sahifalarni joyida tarjima qiladi, tanlangan matn va vizualdagi matnni tarjima qiladi, kichik suhbat qutisi taqdim etadi. Yuqoridagi API kaliti bilan ishlaydi va shu cheklovlarga bo'ysunadi. Do'konlarda hali joyda emas (arizalar qabul qilinmoqda); hozircha qo'lda o'rnatishingiz mumkin:

1. Yuqoridagi brauzeringizga mos keladigan zip faylini yuklab oling va papka ichiga oching.
2. Chrome/Edge: chrome://extensions sahifasida “Developer mode”ni oching, “Load unpacked” bilan ochgan papkangizni tanlang. Firefox: about:debugging → “This Firefox” → “Load Temporary Add-on” (keyingi brauzer qayta ishga tushirishda yana yuklashingiz kerak; Firefox do'koniga ariza berilmoqda).
3. Kengaytma belgisi ustiga bosing va API kalitingizni joylashtiring.

Kompyuter ilovasi

Tilvarni alohida oynada, tizim tepasida va umumiy qisqa yo'l bilan ochiladigan tezkor tarjima qutisi bilan ishlating. Hozircha faqat Windows uchun tayyor; macOS va Linux yaqinda.

Agent rejimi (ixtiyoriy): suhbatda kompyuteringizda buyruq bajarilishini so'rashingiz mumkin. Tilvar buni faqat taklif qiladi; siz ilovada ko'rsatilgan buyruqni ko'z bilan ko'rib tasdiqlamasangiz hech narsa ishlamaydi, shuningdek, diskni formatlash yoki ildizdan o'chirish kabi qaytarilmaydigan bir nechta buyruq shakllari tasdiqlansa ham rad etiladi.

Til kodlari

Tillarlar uch harfli ISO 639-3 kodlari bilan beriladi: Türkçe tur, İngilizce eng, Almanca deu, Fransızca fra, İspanyolca spa, Rusça rus, Çince zho, Japonca jpn, Korece kor, Kazakça kaz, Özbekçe uzb, Azerice aze. To'liq ro'yxat uchun GET /api/languages.

Chegaralar

Server kichik va hamma bilan baham ko'riladi; shuning uchun API dan foydalanish cheklangan. Kalitlar faqat tarjima, chat va vizual nuqtalarda ishlaydi. Veb ilovadagi foydalanish bu cheklovlarga kirmaydi.

Xatolar

Chegarga yetgan so'rovlar 429 va Retry-After sarlavhasi bilan (sekund) qaytariladi; server band bo'lsa 503.

Turk tillariga tarjima har doim Turkiya tili alifbosi bilan qaytadi. Tarjimalar mashinaviy tarjimadir; muhim matnlarni ko'rib chiqing.