{
 "service": "bill-ocr",
 "auth": "Authorization: Bearer <key>  or  X-API-Key: <key>",
 "routes": {
  "POST /v1/bills": "bill -> structured JSON (Claude). ?text=1 adds raw text, ?refresh=1 skips the cache, hint=<note> helps the reader",
  "POST /v1/ocr": "raw text only, free (pdftotext / Tesseract). lang=ara+eng etc. picks Tesseract languages; default eng+tur+ara",
  "GET /v1/bills/<id>": "a stored result",
  "GET /v1/usage": "calls and spend today / this month"
 },
 "upload": "multipart field 'file', raw body with Content-Type, or JSON {file_base64, filename}",
 "limits": {
  "max_mb": 20,
  "max_pages": 30,
  "default_daily_ai_calls_per_key": 200
 }
}