API Dokumentation

Vollständige Referenz der TeaOCR REST-API.

Base URL

https://teaocr.de/api/v1

Authentifizierung

Alle Requests benötigen einen API-Key im Authorization Header:

Header
Authorization: Bearer tea_sk_...

API-Keys erstellen Sie im Dashboard.

POST /ocr

Text aus einem Bild oder PDF extrahieren.

Parameter

FeldTypPflichtBeschreibung
fileFileJaBild oder PDF (max 10 MB)
engineStringNeintesseract (Standard) oder ai (bald)
languageStringNeinSprachcode(s), z.B. deu, deu+eng. Standard: deu
output_formatStringNeintext (Standard) oder hocr

Beispiel

cURL
curl -X POST https://teaocr.de/api/v1/ocr \
  -H "Authorization: Bearer tea_sk_abc123..." \
  -F file=@rechnung.pdf \
  -F engine=tesseract \
  -F language=deu+eng

Response

JSON — 200 OK
{
  "success": true,
  "text": "Rechnung Nr. 2026-0412\nMuster GmbH...",
  "confidence": 0.94,
  "engine": "tesseract",
  "pages": 1,
  "language": "deu+eng",
  "credits_used": 5,
  "credits_remaining": 45
}
GET /usage

Credit-Verbrauch und API-Nutzung abrufen.

cURL
curl https://teaocr.de/api/v1/usage \
  -H "Authorization: Bearer tea_sk_abc123..."

Fehlercodes

CodeBedeutung
401API-Key ungültig oder fehlt
402Nicht genug Credits
413Datei zu groß (max 10 MB)
415Nicht unterstütztes Dateiformat
500Server-Fehler bei der Verarbeitung

Unterstützte Sprachen

deu — Deutsch eng — Englisch fra — Französisch ita — Italienisch spa — Spanisch nld — Niederländisch por — Portugiesisch pol — Polnisch tur — Türkisch

Rate Limits

Starter60 Requests/Minute
Professional300 Requests/Minute
EnterpriseUnbegrenzt (nach Absprache)