Tilvar API

Başlanğıc

1. Hər üzv pulsuz səviyyə daxil olmaqla API-dən istifadə edə bilər; Dəstəkçi və Akademik daha yüksək limitlər alır. Üzvlük səviyyələri
2. Hesab səhifənizdən bir API açarı yaradın. Hesabım
3. Açarı hər sorğuda Authorization: Bearer … başlıqda göndərin.

Açarı heç kimlə paylaşmayın: açarı bilən, limitinizi istifadə edə bilər. Şübhələnirsinizsə hesab səhifəsindən yeni bir açar yaradın; köhnəsi etibarsız olacaq.

Ünvan: https://tilvar.athena.org.tr

Mətn tərcüməsi

POST /api/translate JSON bədəni: text (tərcümə ediləcək mətn), tgt (hədəf dil kodu, məs. tur, eng), seçimlə src (mənbə dil kodu; verilməsə avtomatik aşkarlanır).

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"}'

Cavab:

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

warnings siyahıların itkisi və ya lüğət qaydasının tətbiq edilməməsi kimi xəbərdarlıqlar ehtiva edir; boşdursa heç bir problem görülməyib.

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"])

Söhbət uyğun ucu (brauzer eklentiləri üçün)

POST /v1/chat/completions Söhbət formatındakı sorğuları qəbul edir; bu uç nöqtəsi söhbət etmir, tərcümə edir: model sahəsi tilvar-<hedef dil kodu> formatındadır və son user mesajı o dilə tərcümə edilir.

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"}]}'

Söhbət

POST /api/chat vəziyyətsiz söhbətdir (tarixi müştəri saxlayır). messages son 10 mesajı ehtiva edir, sonuncusu user; tgt tərcümə sorğularının standart hədəf dilidir; web: true köməkçinin lazım olduqda internetdə axtarmasına icazə verir (sorğu Tor vasitəsilə gedir, mənbələr cavabda qayıdır).

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}'

Cavab:

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

Toplu tərcümə

POST /api/translate/batch qısa mətnləri bir sorğuda tərcümə edir (səhifə tərcüməsi üçün). Ən çox 60 element və ümumilikdə 3.500 simvol. Server vaxt həddinə çatarsa dayanır; done neçə elementin tərcümə edildiyini bildirir, qalanları yenidən göndərin.

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 analiz

POST /api/vision çox hissəli (multipart) bir sorğudur. Sahələr:

• image: JPEG, PNG, WebP, GIF və ya BMP, ən çox 8 MB.
• task: describe vizualda nə olduğunu təsvir edir; text içindəki mətni oxuyur; translate mətni oxuyur və tgt dilinə tərcümə edir; ask vizual haqqındakı question sahəsindəki suala cavab verir.
• tgt: təsvir və tərcümə üçün hədəf dil kodu (standart tur).

Hər bir vizual gündəlik API kvotası 1.000 simvol hesablanır. Vizual təhlil edilmir.

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

Cavab (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 eklentisi

Tilvar əlavəsi səhifələri yerində tərcümə edir, seçilmiş mətni və vizualdakı mətni tərcümə edir, kiçik bir söhbət qutusu təqdim edir. Yuxarıdakı API açarı ilə işləyir və eyni məhdudiyyətlərə tabedir. Hələ mağazalarda yayımlanmayıb (müraciət davam edir); hazırda əl ilə qura bilərsiniz:

1. Yuxarıdakı brauzerinizə uyğun zip faylını yükləyin və bir qovluğa çıxarın.
2. Chrome/Edge: chrome://extensions səhifəsində “Developer mode”u açın, “Load unpacked” ilə çıxardığınız qovluğu seçin. Firefox: about:debugging → “This Firefox” → “Load Temporary Add-on” (növbəti brauzer yenidən başladılmasında yenidən yükləməli olacaqsınız; Firefox mağazasına müraciət davam edir).
3. Əlavə simgesinə klikləyin və API açarınızı yapışdırın.

Masaüstü tətbiqi

Tilvarı ayrı bir pəncərədə, sistem tepsisində və ümumi bir qısa yolla açılan sürətli tərcümə qutusu ilə istifadə edin. Hazırda yalnız Windows üçün mövcuddur; macOS və Linux yaxın zamanda.

Agent rejimi (isteğe bağlı): söhbətdə kompüterinizdə bir komanda işlədilməsini istəyə bilərsiniz. Tilvar bunu yalnız təklif edir; siz tətbiqdə göstərilən komandanı gözlərinizlə görüb təsdiqləmədən heç nə işləmir, həmçinin disk formatlama və ya kökdən silmə kimi geri qaytarıla bilməyən bir neçə komanda nümunəsi təsdiqlənsə belə rədd edilir.

Dil kodları

Dillər üç hərflik ISO 639-3 kodları ilə verilir: Türkçe tur, İngilis dili eng, Almanca deu, Fransızca fra, İspanca spa, Rusca rus, Çin dili zho, Yaponca jpn, Koreca kor, Qazaqca kaz, Özbekca uzb, Azərbaycan dili aze. Tam siyahı üçün GET /api/languages.

Sərhədlər

Server kiçikdir və hər kəs ilə paylaşılır; buna görə də API istifadəsi məhduddur. Açarlar yalnız tərcümə, söhbət və vizual nöqtələrdə işləyir. Veb tətbiqindəki istifadə bu məhdudiyyətlərə daxil deyil.

Xətalar

Sərhədə çatmış sorğular 429 və Retry-After başlıqıyla (saniyə) qaytarılır; server yüklənibsə 503.

Türk dillərinə tərcümə həmişə Türkiyə Türkçəsi əlifbası ilə qaytarılır. Tərcümələr maşın tərcüməsidir; vacib mətnləri nəzərdən keçirin.