Tilvar API

Бастау

1. Барлық мүшелер тегін деңгейді қолдана алады; Қолдаушылар мен Академиктер жоғары шектеулерді алады. Мүшелік деңгейлері
2. Есеп парағыңызда API кілтін жасаңыз. Менің есебім
3. Кілтті әр сұрауда Authorization: Bearer … басымында жіберіңіз.

Кілтті ешкіммен бөліспеңіз: кілтті білетін адам сіздің квотаңызды пайдалана алады. Сенімді болмасаңыз, есеп парағынан жаңа кілт жасаңыз; ескісі күшсіз болады.

Мекенжай: https://tilvar.athena.org.tr

Мәтінді аудару

POST /api/translate JSON корпусы: text (аударылатын мәтін), tgt (мақсатты тіл коды, мысалы tur, eng), міндетті емес src (бастапқы тіл коды; берілмесе автоматты анықталады).

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

Жауап:

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

warnings тізімі сандардың жоғалуы немесе сөздік ережесінің қолданылмауы сияқты ескертулерді қамтиды; бос болса, мәселе байқалмады.

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

Сөйлесуге ыңғайлы нүкте (браузер қосымшалары үшін)

POST /v1/chat/completions Сөйлесу форматындағы сұраныстарды қабылдайды; бұл нүкте сөйлеспейді, аударады: model өрісі tilvar-<hedef dil kodu> форматында және соңғы user хабарлама сол тілге аударылады.

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

Сөйлесу

POST /api/chat күйсіз сөйлесу (тарихты клиент сақтайды). messages соңғы 10 хабарламаны қамтиды, соңғысы user; tgt аударма сұраныстарының қалыпты мақсатты тілі; web: true көмекшінің қажет болған жағдайда интернетте іздеуіне рұқсат береді (сұрау Tor арқылы өтеді, дереккөздер жауапта қайтады).

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

Жауап:

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

Топтық аударма

POST /api/translate/batch қысқа мәтіндерді бір сұраныста аударады (бет аудармасы үшін). Максимум 60 элемент және жалпы 3.500 символ. Сервердің уақыт шегіне жетсе тоқтайды; done қанша элемент аударылғанын айтады, қалғандарын қайта жіберіңіз.

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

Визуалды талдау

POST /api/vision көп бөліктелген (multipart) сұраныс. Өрістер:

• image: JPEG, PNG, WebP, GIF немесе BMP, максимум 8 MB.
• task: describe суретте не бар екенін сипаттайды; text ішіндегі мәтінді оқиды; translate мәтінді оқиды және tgt тіліне аударады; ask сурет туралы question өрісіндегі сұраққа жауап береді.
• tgt: сипаттау және аударма үшін мақсатты тіл коды (қалыпты tur).

Әрбір визуалды күнделікті API лимитінен 1.000 символ есептеледі. Визуалдар сақталмайды.

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

Жауап (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"}

Браузер қосымшасы

Tilvar қосымшалары беттерді орнында аударады, таңдалған мәтінді және суреттегі мәтінді аударады, кішігірім чат қорабын ұсынады. Жоғарыдағы API кілтімен жұмыс істейді және сол шектеулерге бағынады. Дүкендерде әлі жарияланбады (өтінім қабылдануда); уақытша қолмен орнатуға болады:

1. Жоғарыдағы браузеріңізге сәйкес келетін zip файлын жүктеп алып, папкаға ашыңыз.
2. Chrome/Edge: chrome://extensions бетінде “Developer mode”ды ашыңыз, “Load unpacked” арқылы аштыңыз. Firefox: about:debugging → “This Firefox” → “Load Temporary Add-on” (келесі браузерді қайта іске қосқанда қайта жүктеуіңіз керек; Firefox дүкеніне өтінім қабылдануда).
3. Қосымша белгісіне басып, API кілтіңізді қойыңыз.

Жұмыс үстелі қосымшасы

Tilvar-ды бөлек терезеде, жүйелік табақта және жалпы қысқаша сілтемемен ашылатын жылдам аударма қорабымен пайдаланыңыз. Қазір тек Windows үшін дайын; macOS және Linux жақында.

Агент режимі (міндетті емес): чатта компьютерде команда орындауды сұрауыңызға болады. Tilvar мұны тек ұсынады; сіз қосымшада көрсетілген команданы көріп, келіспейінше ештеңе жұмыс істемейді, сонымен қатар, дискіні форматтау немесе түбірінен өшіру сияқты кері қайтаруға болмайтын бірнеше команда үлгілері келісілгенімен де, қабылданбайды.

Тіл кодтары

Тілдер үш әріпті ISO 639-3 кодтарымен беріледі: Түрікше tur, Ағылшынша eng, Немецше deu, Французша fra, Испанша spa, Орысша rus, Қытайша zho, Жапонша jpn, Корейше kor, Қазақша kaz, Өзбекше uzb, Азербайжанша aze. Толық тізім үшін GET /api/languages.

Шекаралар

Сервер кіші және барлығымен бөлісіледі; сондықтан API қолдану шектеулі. Кілттер тек аударма, чат және визуалды нүктелерде жұмыс істейді. Веб қосымшадағы қолдану бұл шектеулерге кірмейді.

Қателер

Шектеуге жеткен сұраулар 429 және Retry-After тақырыбымен (секунд) қайтарылады; сервер тығыз болса 503.

Түрік тілдеріне аударма әрқашан Түркия түрікшесі әліпбиімен қайтады. Аудармалар машиналық аударма; маңызды мәтіндерді қарап шығыңыз.