API Docs · v1

Mkalimani REST API

REST API ya kutafsiri Kiswahili kwanza. Lugha 4, sauti, na hati. Built for developers in Tanzania, Kenya, and beyond.

https://api.mkalimani.online/v1Pata Ufunguo wa API →

Bearer Auth

mk_live_... or mk_test_... tokens

Sub-300ms p95

Edge-cached at Nairobi & Frankfurt

OpenAPI 3.1

Generate clients in any language

Request

curl https://api.mkalimani.online/v1/translate \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Habari ya asubuhi",
    "source": "sw",
    "target": "en",
    "voice": false
  }'

Response

{
  "translated": "Good morning",
  "source": "sw",
  "target": "en",
  "pinyin": null,
  "grammar_note": "Habari ya asubuhi literally means 'news of the morning' — used as a greeting until ~11am.",
  "tokens_used": 14,
  "request_id": "req_01HQ8X9V..."
}

Endpoints

POST/v1/translateTafsiri maandishi · Translate text (4 langs)

POST/v1/documentsPakia hati · Upload document for translation

GET/v1/documents/:idHali ya hati · Document status & result

POST/v1/ttsText-to-speech · Returns MP3 stream

GET/v1/usageMatumizi · Your usage and quota

Bei ya API · API Pricing

TZS 0.5

kwa neno · per word translated

TZS 50

kwa ukurasa wa hati · per document page

TZS 5

kwa sekunde ya TTS · per second of audio