Häufige Fragen

OCRCopy Anchor Link

Welchen Text kann die OCR lesen?Copy Anchor Link

Gedruckten Text auf Chinesisch, Englisch, Japanisch, Koreanisch und in den meisten europäischen Sprachen. Setzen Sie language auf die Hauptsprache des Textes: en, zh, ja, ko, fr, de, es, pt, it oder ru. Eine Region wird ignoriert, pt-BR zählt also als pt und zh-TW als zh. Die Sprache wird nicht automatisch erkannt: Ohne language oder mit einem anderen Wert liest die OCR Chinesisch und Englisch (meist auch Japanisch), und koreanischer, kyrillischer oder europäischer Text mit Akzenten wird falsch gelesen. Senden Sie language immer, wenn Sie die Sprache kennen, auch für Japanisch. Handschrift, stark stilisierte Schriftzüge sowie gebogener und vertikaler Text können übersehen oder in Stücke geteilt werden – senden Sie dafür Ihre eigene box.

Was ist ein Eintrag in texts?Copy Anchor Link

Eine Textzeile, kein Wort und kein Absatz. Eine Überschrift über zwei Zeilen kommt als zwei Einträge zurück. Um sie zu ändern, senden Sie eine Ersetzung pro Zeile oder eine Ersetzung, deren box beide Zeilen abdeckt und deren to die ganze neue Überschrift ist, mit \n dort, wo die neue Zeile beginnen soll.

Warum sieht der Text etwas anders aus als im Bild?Copy Anchor Link

Vollbreite Zeichen werden in normaler Breite zurückgegeben: ５０％ＯＦＦ wird zu 50%OFF, und ein vollbreites Leerzeichen wird zu einem normalen Leerzeichen. Manche Sprachen kommen kleingeschrieben zurück (etwa Französisch, Deutsch und Russisch), und Leerzeichen zwischen Wörtern können fehlen: Koreanisch 여름 세일 kann als 여름세일 zurückkommen. Verwenden Sie den zurückgegebenen Text in from; der Abgleich berücksichtigt beides (siehe unten).

Die OCR hat meinen Text übersehen oder falsch gelesen. Was nun?Copy Anchor Link

Senden Sie eine selbst gemessene box (siehe Bilder). Hat eine Ersetzung eine box, wird der Text in der Box ersetzt, und from ist nur ein Hinweis – es muss nicht genau übereinstimmen.

Muss ich die OCR aufrufen?Copy Anchor Link

Nein. Senden Sie from und to ohne box, und POST /edits findet den Text kostenlos für Sie. Dieser Aufruf liest dann zuerst den Text, was meist 5–20 Sekunden dauert (so lange wie POST /ocr); planen Sie für die HTTP-Anfrage also mindestens 90 Sekunden ein. Die OCR belegt keinen Ihrer 10 Job-Plätze. Rufen Sie POST /ocr nur zuerst auf, wenn Sie dem Nutzer den Text zeigen, ihn wählen lassen oder die Boxen prüfen möchten, bevor Sie für eine Bearbeitung zahlen.

Was, wenn from nur ein Teil einer Zeile ist?Copy Anchor Link

Nur dieser Teil ändert sich. from: "OFF", to: "ON" in der Zeile 50% OFF ergibt 50% ON. In der Antwort zeigt replacements die ganze Zeile: from: "50% OFF", to: "50% ON". Diese Werte stammen aus der OCR-Lesung der Zeile und können daher kleingeschrieben sein oder Leerzeichen verlieren (siehe oben). Der neue Text wird im Stil der ursprünglichen Zeile gezeichnet: Prüfen Sie Groß- und Kleinschreibung und Abstände im Bild, nicht in diesem Text.

Beim Abgleich werden Groß-/Kleinschreibung und umgebende Leerzeichen ignoriert. Stimmen einige Zeilen genau mit from überein, ändern sich nur diese, und Zeilen, die es nur enthalten, bleiben unverändert. Andernfalls ändert sich jede Zeile, die es enthält, an jeder Stelle der Zeile: from: "e" macht aus Summer Collection den Text Summ3r Coll3ction, wenn to gleich 3 ist. match: "first" beschränkt die Änderung auf eine Zeile, nicht auf eine Stelle – senden Sie eine box und die ganze neue Zeile, wenn Sie genaue Kontrolle brauchen. Passt nichts, gibt es einen weiteren Versuch, der alle Leerzeichen ignoriert, sodass 여름 세일 die Zeile 여름세일 trotzdem findet.

Wird die OCR berechnet, wenn das Bild keinen Text hat?Copy Anchor Link

Ja. Der Aufruf liefert "texts": [] und zählt als ein OCR-Aufruf. Dasselbe Bild innerhalb von 24 Stunden wird nicht erneut berechnet.

Wie ist es mit Arabisch, Hebräisch, Thai oder Hindi?Copy Anchor Link

Nicht unterstützt. Die OCR kann trotzdem Zeilen in diesen Schriften liefern, aber die Erkennung und das bearbeitete Ergebnis sind nicht garantiert. Ein Job, der daran scheitert, wird nicht berechnet.

Kann ich ein PDF oder mehrere Seiten auf einmal senden?Copy Anchor Link

Nein. Jede Anfrage nimmt ein JPEG-, PNG- oder WebP-Bild an. Rendern Sie jede Seite, die Sie ändern möchten, als Bild und senden Sie eine Anfrage pro Seite – sie können gleichzeitig laufen, bis zu Ihren 10 Job-Plätzen.

BearbeitungCopy Anchor Link

Kann ich Schrift, Farbe oder Größe wählen?Copy Anchor Link

Nein. Der neue Text übernimmt Schrift, Farbe, Größe und Effekte des Textes, den er ersetzt. Es gibt keine Stilparameter.

Was, wenn der neue Text länger oder kürzer ist?Copy Anchor Link

Er wird in den Raum um den ursprünglichen Text eingepasst, ohne benachbarten Text zu verdecken. Sehr langer Text kann kleiner ausfallen. Bleiben Sie nah an der ursprünglichen Länge, um das natürlichste Ergebnis zu erhalten.

Kann ich Text entfernen statt ersetzen?Copy Anchor Link

Ja – um Text zu entfernen, setzen Sie to auf einen leeren String. Der Hintergrund dahinter wird aufgefüllt.

Wie lang dürfen from und to sein?Copy Anchor Link

Jeweils bis zu 200 Unicode-Zeichen (ein Emoji zählt als eins). \n in to beginnt eine neue Zeile. from darf nur leer sein, wenn Sie eine box senden.

Wie viele Änderungen kann eine Bearbeitung machen?Copy Anchor Link

Bis zu 20 Ersetzungen pro Bild, alle in einem Job und als eine Bearbeitung berechnet. Kommen dieselben Wörter mehrmals vor, ändert match: "all" (Standard) alle und match: "first" nur das erste, von oben nach unten und von links nach rechts; senden Sie Boxen, um genau zu wählen. Senden Sie keine zwei Ersetzungen für denselben Text und keine überlappenden Boxen – nur eine davon wird angewendet, und welche, ist nicht festgelegt.

Wie ordne ich replacements in der Antwort meiner Anfrage zu?Copy Anchor Link

Die Antwort hat einen Eintrag pro geänderter Zeile, in der Reihenfolge Ihrer Anfrage. Eine Ersetzung ohne box, die drei Zeilen getroffen hat, wird zu drei Einträgen, von oben nach unten. Brauchen Sie eine Eins-zu-eins-Zuordnung, senden Sie für jede Ersetzung eine box oder verwenden Sie match: "first".

Kann es Dinge ändern, die kein Text sind?Copy Anchor Link

Nein. Nur der Text, den Sie angeben, wird geändert. Logos, Gesichter und andere Objekte werden bewusst nicht bearbeitet.

Wie lange dauert ein Job?Copy Anchor Link

Meist 1–2 Minuten: 9 von 10 Jobs sind in 3 Minuten fertig, fast alle in 5. estimated_seconds in der Antwort ist unsere Schätzung, wann er fertig ist; ein Job kann nach Verlassen der Warteschlange bis zu 10 Minuten laufen, und bei voller Warteschlange mit 30 Jobs kann der letzte etwa 30 Minuten dauern. Jeder Job ist innerhalb von 60 Minuten nach dem Senden succeeded oder failed; ist er es nicht, beenden Sie das Polling und schreiben Sie mit seiner id an [email protected]. Siehe Warteschlange und Limits.

ErgebnisseCopy Anchor Link

Soll ich A oder B verwenden?Copy Anchor Link

B lässt jedes Pixel außerhalb des Textes genau wie in Ihrem Upload – die sichere Wahl für Produktfotos, Dokumente und alles, bei dem sich der Rest des Bildes nicht ändern darf. A zeichnet das ganze Bild neu, was den neuen Text oft natürlicher einfügt, aber an anderen Stellen kleine Details ändern kann. Wir empfehlen, Ihrem Nutzer jedes erfolgreiche Ergebnis zu zeigen – A und B, dazu C (4K), wenn vorhanden – und ihn wählen zu lassen.

Was ist C, und warum wurde es übersprungen?Copy Anchor Link

C ist die in 4K erzeugte KI-Bearbeitung, bis zu 3840 px an der längsten Seite. Bei Bildern, die breiter oder höher als 3:1 sind, wird sie übersprungen (aspect_ratio_unsupported), und sie kann auch für sich allein fehlschlagen. C ändert nie, was Ihnen berechnet wird.

Haben Ergebnisse ein Wasserzeichen? Wie lange werden sie aufbewahrt?Copy Anchor Link

Kein Wasserzeichen. Ergebnislinks sind öffentliche JPEG-Dateien auf img.rewords.ai, die mindestens 7 Tage aufbewahrt werden – laden Sie herunter, was Sie brauchen. Die Links eines Jobs ändern sich zwischen Abfragen nicht. GET /edits/{id} funktioniert, solange die Links aufbewahrt werden. Hochgeladene Bilder hinter einer image_id werden 24 Stunden aufbewahrt.

Kann ich ein Ergebnis erneut bearbeiten?Copy Anchor Link

Ja. Übergeben Sie die url des Ergebnisses als image_url in einer neuen Bearbeitung – Ergebnis B ist der beste Ausgangspunkt. Es ist ein neuer Job und wird wie jeder andere berechnet. Tun Sie das, wenn Sie Text schrittweise ändern oder das erste Ergebnis eine zweite Änderung braucht.

Kann ich einen Job abbrechen?Copy Anchor Link

Nein, es gibt keinen Abbruch-Aufruf. Ein Job kostet nur dann eine Bearbeitung, wenn er succeeded erreicht; brauchen Sie ihn nicht mehr, ignorieren Sie das Ergebnis. Ein nie gesendeter Job kostet nichts, prüfen Sie Ihren Text also vor dem Senden mit POST /ocr.

Ein Job ist fehlgeschlagen. Wie wiederhole ich ihn?Copy Anchor Link

Fehlgeschlagene Jobs sind kostenlos. Senden Sie erneut mit einem neuen Idempotency-Key: Der alte liefert denselben fehlgeschlagenen Job. ai_generation_failed und upstream_failed gelingen beim erneuten Versuch oft; content_blocked nicht.

AbrechnungCopy Anchor Link

Wann genau wird mir etwas berechnet?Copy Anchor Link

Eine Bearbeitung pro Job, nur wenn A oder B gelingt – auch wenn das andere fehlschlägt. Beim Senden wird eine Bearbeitung reserviert, damit bereits wartende Jobs immer fertig werden können; sie wird freigegeben, wenn der Job fehlschlägt. In balance und edits_remaining sind reservierte Bearbeitungen bereits abgezogen. Siehe Preise und Abrechnung.

Gibt es einen kostenlosen Testschlüssel oder eine Sandbox?Copy Anchor Link

Es gibt keine kostenlosen Testschlüssel. Bearbeiten Sie ein Bild kostenlos auf rewords.ai, um die Qualität zu sehen, und beginnen Sie dann mit dem Lite-Paket. Fehlgeschlagene Jobs und abgelehnte Anfragen werden nie berechnet.

IntegrationCopy Anchor Link

Kann ich die API aus einem Browser oder einer mobilen App aufrufen?Copy Anchor Link

Nein. Rufen Sie sie von Ihrem Server auf. Der API-Schlüssel wäre im Frontend-Code oder im App-Paket sichtbar, und jeder, der ihn findet, könnte Ihr Guthaben ausgeben. Die API sendet keine CORS-Header, Browser blockieren direkte Aufrufe also.

Polling oder Webhooks?Copy Anchor Link

Beides geht. Webhooks brauchen einen öffentlichen https-Endpunkt und sparen Anfragen; Polling braucht nichts. Kann Ihr Endpunkt ausfallen, fragen Sie zusätzlich jeden Job, von dem Sie 15 Minuten nach dem Senden nichts gehört haben, alle paar Minuten ab, bis er endgültig ist. Ein später eintreffender Webhook schadet nicht: Sie überspringen die id, die Sie bereits verarbeitet haben. Siehe Webhooks.

Wie verknüpfe ich einen Job mit meiner eigenen Bestellung oder meinem Nutzer?Copy Anchor Link

Speichern Sie die id aus der 202-Antwort neben Ihrem Datensatz. Für Webhooks können Sie auch eine eigene Referenz an den Query-String von callback_url anhängen, der erhalten bleibt: https://example.com/hooks/rewords?order=1234.

Meine Anfrage lief in einen Timeout. Wurde ein Job angelegt?Copy Anchor Link

Vielleicht. Wiederholen Sie mit demselben Idempotency-Key: Wurde er angelegt, erhalten Sie den Job zurück, und er wird nicht doppelt berechnet. Siehe Fehler.

Ändert sich die API ohne Vorwarnung?Copy Anchor Link

Die Version steht im Pfad: /v1. Innerhalb von /v1 fügen wir nur hinzu – neue optionale Felder, neue Werte in reason oder error.code –, ignorieren Sie also Felder, die Sie nicht kennen, und behandeln Sie einen unbekannten Code wie upstream_failed. Alles, was einen Client brechen würde, kommt in eine neue Version, die per E-Mail angekündigt wird, bevor die alte eingestellt wird. Fragen an [email protected].

Gibt es ein SDK?Copy Anchor Link

Noch nicht. Laden Sie openapi.yaml herunter und erzeugen Sie mit einem beliebigen OpenAPI-3.1-Generator einen Client, oder kopieren Sie die vollständigen Node.js- und Python-Clients unter Beispiele.

Mein API-Schlüssel ist durchgesickert. Was tun?Copy Anchor Link

Widerrufen Sie ihn auf der Seite mit den API-Schlüsseln – er funktioniert innerhalb einer Minute nicht mehr – und erstellen Sie einen neuen. Alle Schlüssel teilen sich Ihr Guthaben, tun Sie das also zuerst und prüfen Sie danach GET /account. Ist auch das Webhook-Secret durchgesickert, setzen Sie es auf derselben Seite zurück. Siehe Authentifizierung.

In welcher Zeitzone sind created_at und completed_at?Copy Anchor Link

UTC, im ISO-8601-Format mit dem Suffix Z: 2026-11-04T10:00:00Z.

Hilfe erhaltenCopy Anchor Link

Schreiben Sie an [email protected] oder nutzen Sie die Kontaktseite für WhatsApp und TikTok. E-Mail ist der schnellste Weg für API-Fragen.

Geben Sie an, was uns hilft, die Anfrage zu finden:

• die Job-id (edit_...) oder image_id und die Uhrzeit der Anfrage in UTC;
• die ersten 12 Zeichen des verwendeten Schlüssels (rw_live_abcd...) – niemals den ganzen Schlüssel;
• den erhaltenen error.code und die message, oder das Ergebnis, das falsch aussieht;
• das Bild, wenn Sie es teilen können, und die gesendeten replacements.

Eine Frage zur Abrechnung braucht außerdem die E-Mail-Adresse Ihres rewords.ai-Kontos, damit wir den Kauf finden.