Démarrage rapide
Remplacez le texte de votre première image avec l’API ReWords.AI — OCR, envoi de la modification et récupération des résultats en trois requêtes curl.
Il vous faut une clé d’API : achetez un pack API, puis créez une clé sur votre page des clés d’API (voir Authentification). Définissez-la dans votre terminal :
export REWORDS_API_KEY=rw_live_your_key1. Trouver le texte
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
}Les cadres sont [x, y, largeur, hauteur] sur une échelle de 0 à 1000 de l’image : ils ne dépendent donc pas de sa taille en pixels.
L’image_id est réutilisable pendant 24 heures, vous n’avez donc pas à renvoyer l’image.
Mettez dans language la langue du texte de l’image — ko pour le coréen, ja pour le japonais, etc. Elle n’est pas
détectée automatiquement et, sans elle, l’OCR ne lit bien que le chinois et l’anglais (voir la FAQ).
2. Envoyer la modification
Envoyez un box issu du résultat OCR, ou seulement from et to, et nous localisons le texte pour vous.
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 indique le cadre trouvé pour 50% OFF, et une modification est déjà réservée dans balance.
Utilisez un nouvel Idempotency-Key pour chaque nouvelle tâche, et le même uniquement pour renvoyer cette tâche : une clé réutilisée renvoie
la tâche précédente, pas une nouvelle modification.
3. Récupérer les résultats
Interrogez jusqu’à ce que status vaille succeeded ou failed : toutes les 5 secondes tant qu’elle est processing ou queued avec
queue_position à 0, et toutes les 30 secondes tant qu’elle est plus loin dans la file — voir
File d’attente et limites. Ou passez callback_url et recevez un webhook à la place.
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"
}Voir Exemples pour des clients complets en Node.js et Python et toutes les autres réponses.
Téléchargez les images dont vous avez besoin : les résultats sont des fichiers JPEG accessibles par des liens publics conservés au moins 7 jours. Voir Résultats et remboursements pour savoir ce que sont A, B et C, et Images pour envoyer un fichier local au lieu d’une URL.
API de modification de texte dans les images
Remplacez le texte des images par IA en conservant la police, la couleur et le fond d’origine. OCR, modifications, résultats et webhooks via une API REST simple.
Exemples
Clients Node.js et Python complets pour l’API ReWords.AI, et chaque réponse que vous rencontrerez — OCR, une modification en file, en cours, réussie, partiellement échouée et échouée, et chaque erreur.