Skip to main content
FreeAIOCR logoFreeAIOCR
API-Dokumentation

API-Überblick

Integrieren Sie Texterkennung und Tabellenextraktion mit gemeinsamem API-Schlüssel und Kontoguthaben bei nutzungsabhängiger Abrechnung.

APIAPI KeysAPI-Abrechnung

API auswählen

  • Bild zu Text

    Extrahieren Sie Dokumente als Markdown-JSON, Klartext-JSON oder bearbeitbare Word-Datei.

    POST /api/v1/image-to-text
  • Bild zu Tabelle

    Extrahieren Sie Tabellenstrukturen als JSON, CSV oder Excel.

    POST /api/v1/image-to-table

Mit der FreeAIOCR API erkennen Sie Text und extrahieren Tabellen aus Bildern. Die API-Referenzen oben beschreiben jeweils unterstützte Eingaben und Ausgabeformate.

Schnellstart

  1. Bestätigen Sie die E-Mail-Adresse Ihres Kontos
  2. Erstellen Sie in den Einstellungen einen API-Schlüssel und speichern Sie ihn sicher: er wird nur einmal angezeigt
  3. Laden Sie $5 API-Guthaben auf. Alle Schlüssel teilen das Guthaben, das von Website-Abos unabhängig ist und nicht verfällt
  4. Senden Sie das Beispiel vom Server und ersetzen Sie YOUR_API_KEY und document.png
  5. Prüfen Sie Text, Tokenverbrauch und Abrechnung in der Antwort

Authentifizierung

Authorization: Bearer YOUR_API_KEY

Übertragen Sie den Bearer-Schlüssel nur über HTTPS und bewahren Sie ihn auf dem Server auf. Browser-Anfragen über Origin-Grenzen werden nicht unterstützt. Veröffentlichen Sie den Schlüssel niemals im Quellcode.

Erste Anfrage senden

Verwenden Sie POST mit Bearer-Schlüssel und genau einer Datei im Feld image. Ersetzen Sie YOUR_API_KEY und document.png. cURL setzt Multipart-Content-Type und Grenze selbst. Nur der optionale Abfrageparameter format ist erlaubt, keine zusätzlichen Formularfelder oder Modelleinstellungen. Rufen Sie vom Server auf; Browser-Aufrufe über Origin-Grenzen werden nicht unterstützt. Veröffentlichen Sie den Schlüssel nie.

curl --silent --show-error --include --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png'

Antwort lesen

Die folgende JSON-Antwort ist ein Beispiel; erkannter Text und Tokenverbrauch hängen vom Bild ab.

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "text": "# Document title\n\nRecognized paragraph.\n\n| Item | Count |\n| --- | --- |\n| Books | 12 |",
  "usage": {
    "input_tokens": 2000,
    "output_tokens": 4000
  },
  "billing": {
    "currency": "USD",
    "price_version": "2026-10-26-v1",
    "base_usd": "0.002000000",
    "input_overage_usd": "0.000000000",
    "output_overage_usd": "0.002400000",
    "total_usd": "0.004400000"
  }
}

Sichere Wiederholungen

Bei Netzwerkfehlern dieselbe Idempotency-Key und das Originalbild erneut verwenden. Für neue Vorgänge jeweils eine neue eindeutige ID einsetzen. Solange Ergebnis oder Abrechnung unklar sind, keinen weiteren Vorgang starten. Details stehen in der Wiederholungsstrategie.

Diese Anleitungen gelten für Bild zu Text und Bild zu Tabelle. Eingaben, Formate und spezifische Fehler finden Sie in der jeweiligen API-Referenz.