Anlat API

Metin sadeleştirme API dokümantasyonu

Authentication

Tüm isteklerde x-api-key header'ı gereklidir.

curl -X POST https://www.anlat.site/api/v1/simplify \
  -H "Content-Type: application/json" \
  -H "x-api-key: anlat_YOUR_API_KEY" \
  -d '{"text": "..."}'

POST /api/v1/simplify

Metni sadeleştirir.

Request Body

Parametre	Tip	Zorunlu	Açıklama
text	string	Evet	Sadeleştirilecek metin (maks 5000 karakter)
level	string	Hayır	"child" \| "student" \| "adult" (varsayılan: "adult")
domain	string	Hayır	"auto" \| "general" \| "legal" \| "medical" \| ... (varsayılan: "auto")
language	string	Hayır	"tr" \| "en" (varsayılan: "tr")
includeTerms	boolean	Hayır	true ise terim açıklamaları döner

Response

{
  "simplified": "Simplified text...",
  "originalLength": 189,
  "simplifiedLength": 150,
  "model": "gemini-2.0-flash-lite",
  "domain": "legal",
  "detectedDomain": "legal",
  "terms": [
    { "term": "plaintiff", "explanation": "Person who files a lawsuit" }
  ]
}

Rate Limiting

Her API key'in günlük kullanım limiti vardır. Limit aşıldığında 429 döner.

{
  "error": "Daily rate limit exceeded.",
  "used": 100,
  "limit": 100
}

Hata Kodları

Kod			Açıklama
401			Geçersiz veya eksik API key
400			Geçersiz parametre
429			Günlük limit aşıldı
500			Sunucu hatası