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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| file | File | Ja | Bild oder PDF (max 10 MB) |
| engine | String | Nein | tesseract (Standard) oder ai (bald) |
| language | String | Nein | Sprachcode(s), z.B. deu, deu+eng. Standard: deu |
| output_format | String | Nein | text (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
| Code | Bedeutung |
|---|---|
| 401 | API-Key ungültig oder fehlt |
| 402 | Nicht genug Credits |
| 413 | Datei zu groß (max 10 MB) |
| 415 | Nicht unterstütztes Dateiformat |
| 500 | Server-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)