Schnellstart
Ersetzen Sie Text in Ihrem ersten Bild mit der ReWords.AI API – OCR, Bearbeitung senden und Ergebnisse abholen mit drei curl-Anfragen.
Sie brauchen einen API-Schlüssel: Kaufen Sie ein API-Paket und erstellen Sie dann einen Schlüssel auf Ihrer Seite für API-Schlüssel (siehe Authentifizierung). Setzen Sie ihn in Ihrer Shell:
export REWORDS_API_KEY=rw_live_your_key1. Text finden
curl https://api.rewords.ai/v1/ocr \
-H "Authorization: Bearer $REWORDS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_url": "https://example.com/banner.png", "language": "en"}'{
"image_id": "img_abc123",
"width": 1080,
"height": 1350,
"texts": [
{ "id": "t1", "text": "SALE", "box": [120, 80, 300, 60] },
{ "id": "t2", "text": "50% OFF", "box": [140, 160, 260, 50] }
],
"charged_ocr": 1
}Boxen sind [x, y, Breite, Höhe] auf einer Skala von 0–1000 des Bildes und hängen daher nicht von seiner Pixelgröße ab.
Die image_id lässt sich 24 Stunden lang wiederverwenden, Sie laden das Bild also nicht erneut hoch.
Setzen Sie language auf die Sprache des Textes im Bild – ko für Koreanisch, ja für Japanisch und so weiter. Sie wird
nicht automatisch erkannt, und ohne sie liest die OCR nur Chinesisch und Englisch zuverlässig (siehe FAQ).
2. Bearbeitung senden
Senden Sie eine box aus dem OCR-Ergebnis oder nur from und to – dann suchen wir den Text für Sie.
curl https://api.rewords.ai/v1/edits \
-H "Authorization: Bearer $REWORDS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"image_id": "img_abc123",
"replacements": [
{ "from": "SALE", "to": "HOT DEAL", "box": [120, 80, 300, 60] },
{ "from": "50% OFF", "to": "70% OFF" }
]
}'{
"id": "edit_9f8e7d",
"status": "queued",
"queue_position": 0,
"estimated_seconds": 120,
"replacements": [
{ "from": "SALE", "to": "HOT DEAL", "box": [120, 80, 300, 60] },
{ "from": "50% OFF", "to": "70% OFF", "box": [140, 160, 260, 50] }
],
"balance": 4,
"created_at": "2026-11-04T13:55:33.240Z"
}replacements zeigt die Box, die wir für 50% OFF gefunden haben, und in balance ist bereits eine Bearbeitung reserviert.
Verwenden Sie für jeden neuen Job einen neuen Idempotency-Key und denselben nur, um genau diesen Job erneut zu senden – ein wiederverwendeter
Schlüssel liefert den früheren Job zurück, keine neue Bearbeitung.
3. Ergebnisse abholen
Fragen Sie ab, bis status succeeded oder failed ist: alle 5 Sekunden, solange der Job processing ist oder queued mit
queue_position 0, und alle 30 Sekunden, solange er weiter hinten in der Warteschlange steht – siehe
Warteschlange und Limits. Oder übergeben Sie callback_url und empfangen Sie stattdessen einen Webhook.
curl https://api.rewords.ai/v1/edits/edit_9f8e7d \
-H "Authorization: Bearer $REWORDS_API_KEY"{
"id": "edit_9f8e7d",
"status": "succeeded",
"results": {
"A": { "status": "succeeded", "url": "https://img.rewords.ai/api/edit_9f8e7d_a.jpg" },
"B": { "status": "succeeded", "url": "https://img.rewords.ai/api/edit_9f8e7d_b.jpg" },
"C": { "status": "succeeded", "url": "https://img.rewords.ai/api/edit_9f8e7d_c.jpg" }
},
"replacements": [
{ "from": "SALE", "to": "HOT DEAL", "box": [120, 80, 300, 60] },
{ "from": "50% OFF", "to": "70% OFF", "box": [140, 160, 260, 50] }
],
"charged": 1,
"balance": 4,
"created_at": "2026-11-04T13:55:33.240Z",
"completed_at": "2026-11-04T13:56:21.808Z"
}Vollständige Clients in Node.js und Python sowie alle weiteren Antworten finden Sie unter Beispiele.
Laden Sie die Bilder herunter, die Sie brauchen – Ergebnisse sind JPEG-Dateien unter öffentlichen Links, die mindestens 7 Tage bestehen bleiben. Was A, B und C sind, steht unter Ergebnisse und Erstattungen; wie Sie statt einer URL eine lokale Datei hochladen, unter Bilder.
API zum Bearbeiten von Text in Bildern
Ersetzen Sie Text in Bildern mit KI und behalten Sie Schrift, Farbe und Hintergrund bei. OCR, Bearbeitungen, Ergebnisse und Webhooks über eine einfache REST-API.
Beispiele
Vollständige Node.js- und Python-Clients für die ReWords.AI API und jede Antwort, der Sie begegnen – OCR, eine wartende, laufende, erfolgreiche, teilweise fehlgeschlagene und fehlgeschlagene Bearbeitung sowie jeder Fehler.