API Documentation

Everything you need to integrate Modulang translation into your application.

Authentication

All API requests require authentication using a Bearer token. You can generate API keys from your dashboard.

Authorization: Bearer YOUR_API_KEY

Base URL

All API requests should be made to:

https://api.modulang.com/v1

Translate Text

POST/translate

Translate text from one language to another.

Request Body

Parameter	Type	Required	Description
text	string	Yes	The text to translate
source_lang	string	No	Source language code (auto-detected if not provided)
target_lang	string	Yes	Target language code

Examples

curl -X POST https://api.modulang.com/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, world!",
    "source_lang": "en",
    "target_lang": "ko"
  }'

Response

{
  "translated_text": "안녕하세요, 세상!",
  "source_lang": "en",
  "target_lang": "ko",
  "tokens_used": 12,
  "model": "translategemma-12b"
}

Supported Languages

Modulang supports translation between 57 languages based on TranslateGemma WMT24++:

arArabic

bgBulgarian

bnBengali

caCatalan

csCzech

daDanish

deGerman

elGreek

enEnglish

esSpanish

etEstonian

faPersian

fiFinnish

filFilipino

frFrench

guGujarati

heHebrew

hiHindi

hrCroatian

huHungarian

idIndonesian

isIcelandic

itItalian

jaJapanese

knKannada

koKorean

loLao

ltLithuanian

lvLatvian

mlMalayalam

mrMarathi

msMalay

nlDutch

noNorwegian

paPunjabi

plPolish

ptPortuguese

roRomanian

ruRussian

skSlovak

slSlovenian

srSerbian

svSwedish

swSwahili

taTamil

teTelugu

thThai

trTurkish

ukUkrainian

urUrdu

viVietnamese

zh-CNChinese (Simplified)

zh-TWChinese (Traditional)

zuZulu

Rate Limits

API rate limits are based on your subscription plan:

Plan	Requests/min	Tokens/month
Free	5	10,000
Pro	60	500,000
Enterprise	Custom	Unlimited

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1703328000

Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
403	Forbidden - Quota exceeded
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

SDKs

Official SDKs coming soon for Python, JavaScript/TypeScript, Go, and more. For now, use the REST API directly with your favorite HTTP client.