Bild zu Text

POST /api/v1/image-to-text

Anfrage

Senden Sie mit POST genau ein Bild im Multipart-Feld image; ersetzen Sie YOUR_API_KEY und document.png. Die Multipart-Grenze setzt cURL. Nur der optionale Parameter format ist erlaubt, keine zusätzlichen Formularfelder oder Modelleinstellungen. Beachten Sie die Bearer-Authentifizierung und Schlüsselsicherheit.

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'

Das JSON ist ein Beispiel; erkannter Text und Tokenverbrauch hängen vom Bild ab. Regeln für Wiederholungen stehen unter Idempotenz.

Erfolgsantwort (Beispielnutzung)

{
  "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"
  }
}

Ausgabeformate

Erlaubt ist genau ein optionaler Parameter format=json|text|docx. Unbekannte Parameter, doppelte Angaben und ungültige Werte führen vor der Erkennung zu 400. json (Standard) liefert Markdown in text, gegebenenfalls mit HTML-Tabellen und LaTeX. text wandelt nur dieses Feld in Klartext um; usage und billing bleiben erhalten. docx liefert den Word-Anhang result.docx.

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

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

Word verwendet Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document und Content-Disposition: attachment. Die Datei nur bei erfolgreichem cURL-Aufruf und passendem Content-Type verwenden. X-Request-Id, X-OCR-Charged-USD und X-OCR-Price-Version beziehen sich auf die ursprüngliche Erkennung. Cache-Control: no-store und gegebenenfalls Idempotency-Replayed bleiben erhalten.

Innerhalb von 24 Stunden können Sie mit demselben Konto, Bild, MIME und Idempotency-Key das Format ohne erneute Erkennungsgebühr wechseln. Nach Ablauf kann ein neuer kostenpflichtiger Vorgang beginnen. Alte Klartextergebnisse erhalten durch die Konvertierung keine verlorene Struktur zurück.

export_failed (503) bedeutet: Erkennung erfolgreich und bereits berechnet, Konvertierung fehlgeschlagen; recognition_succeeded im JSON-Fehler ist true. Mit ursprünglichem Bild und Schlüssel vor Ablauf wiederholen oder format=json abrufen. Keine Erstattung und keine neue Erkennung. Word enthält bearbeitbaren Text und Tabellen, keine exakte Layoutkopie; Formeln bleiben LaTeX-Text.

Für jeden neuen Vorgang oder anderen Endpunkt ist ein neuer Idempotency-Key erforderlich. Derselbe Schlüssel für Text- und Tabellen-API ergibt 409 idempotency_conflict. Bei einem Formatwechsel derselben Operation bleiben Schlüssel und Bild unverändert. Siehe Idempotenz und Preise.