# Tilmoch API

> Translation API for Turkic languages by Tahrirchi. One REST endpoint, two AI translation models (Tilmoch and Sayqalchi), sixteen supported languages including Uzbek, Karakalpak, Kazakh, Kyrgyz, Turkmen, Azerbaijani, Turkish, Tajik, Georgian, Russian, English, Chinese and Korean. Pay-as-you-go pricing with free starting credit. MCP server support is planned.

Key facts:
- Endpoint: `POST https://websocket.tahrirchi.uz/translate-v2`
- Auth: `Authorization: YOUR_API_KEY` header (get a key by registering at the portal)
- Request JSON fields: `text` (string, max 5000 chars), `source_lang`, `target_lang`, `model` ("tilmoch" or "sayqalchi")
- Response JSON: `{ "translated_text": "..." }`
- Batch: send `texts` (array of strings) instead of `text` to translate many at once; response returns `translated_texts` (array, same order). `source_lang`/`target_lang`/`model` apply to the whole batch.
- Language codes: uzn_Latn, uzn_Cyrl, uzs_Arab, kaa_Latn, kaa_Cyrl, kaz_Cyrl, kir_Cyrl, tuk_Latn, azj_Latn, tur_Latn, tgk_Cyrl, kat_Geor, rus_Cyrl, eng_Latn, zho_Hans, kor_Hang
- Models: tilmoch (fast, 0.2 UZS/char), sayqalchi (higher quality, 0.35 UZS/char, recommended)
- Limits: 5000 characters per request, 50 requests per minute
- New accounts get 1,000 UZS free credit

## Docs

- [API Documentation](https://platform.tahrirchi.uz/docs): full reference with code examples in cURL, JavaScript, Python, PHP, Ruby, Go and Java
- [Full reference for LLMs](https://platform.tahrirchi.uz/llms-full.txt): complete API reference in a single markdown file
- [Pricing](https://platform.tahrirchi.uz/pricing): pay-as-you-go pricing and FAQ

## Optional

- [Tahrirchi](https://tahrirchi.uz): Uzbek grammar and spell checking product
- [Tilmoch](https://tilmoch.ai): consumer translation product built on the same models