Bild zu Tabelle | FreeAIOCR

POST /api/v1/image-to-table

Senden Sie ein Bild im Multipart-Feld image an POST /api/v1/image-to-table. format unterstützt nur json (Standard), csv und xlsx. Ersetzen Sie YOUR_API_KEY und table.png, und senden Sie den Aufruf serverseitig nach den Bearer-Anweisungen.

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

Die JSON-Antwort enthält request_id, usage, billing sowie tables mit {title, html}. Das HTML wird sicher bereinigt. Table N ist ein Ersatzname und kein erkannter Originaltitel. Der rohe Modelltext wird nicht veröffentlicht.

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "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"
  },
  "tables": [
    {
      "title": "Sales",
      "html": "<table><tbody><tr><th>Item</th><th>Qty</th></tr><tr><td>Notebook</td><td>0012</td></tr></tbody></table>"
    }
  ]
}

Für dasselbe Bild und denselben Idempotency-Key lassen sich weitere Formate ohne neue Erkennung oder Berechnung abrufen:

curl --silent --show-error --fail --output tables.csv --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-table?format=csv' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-table-request-0001' \
  -F 'image=@table.png'

curl --silent --show-error --fail --output tables.xlsx --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-table?format=xlsx' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-table-request-0001' \
  -F 'image=@table.png'

CSV: eine Tabelle ergibt normales UTF-8-CSV. Bei mehreren Tabellen beginnt jeder durch Leerzeilen getrennte Abschnitt mit # Table N: Title. Das ist keine einzelne standardkonforme CSV-Tabelle: Abschnitte vor dem Import aufteilen. Formelartige Inhalte werden neutralisiert
XLSX: pro Tabelle ein separates Table N-Arbeitsblatt; verbundene Zellen bleiben erhalten. Alle Zellen, auch Zahlen mit führenden Nullen, werden als Text gespeichert. Vor Berechnungen prüfen
Eingabe: Die API unterstützt nur ein PNG-, JPEG- oder WebP-Bild bis 10 MB. Das Webwerkzeug akzeptiert zusätzlich HEIC, HEIF und BMP, die API jedoch nicht. Keine PDF-, Mehrseiten- oder Stapelverarbeitung; ein Bild darf mehrere Tabellen enthalten

Tabellenspezifische Fehler und gemeinsame Regeln

Wenn keine gültige Tabelle erkannt wird, antwortet die API vor der Abrechnung mit 422 no_tables, gibt die Reservierung frei und berechnet nichts. Schlägt CSV/XLSX nach erfolgreicher Erkennung und Abrechnung fehl, folgt 503 export_failed mit recognition_succeeded: true. Fordern Sie innerhalb des Replayfensters format=json mit demselben Bild, Konto und Idempotency-Key an; starten Sie bei unklarer Belastung keinen neuen Vorgang. Fehler sind JSON mit request_id, error.code und Cache-Control: no-store; erfolgreiche Downloads enthalten X-Request-Id, X-OCR-Charged-USD und X-OCR-Price-Version.

Ein Wechsel von format führt nicht zu erneuter Erkennung oder Berechnung. Abgeschlossene Ergebnisse lassen sich 24 Stunden wiedergeben; auch Replays zählen zum Anfragelimit. Die Wiederverwendung des Schlüssels zwischen Endpunkten ergibt 409 idempotency_conflict; das API-Guthaben ist unabhängig von Web-Gutschriften. Siehe Preise und Reservierung, Anfragelimits und Idempotenz / Wiederholungen.