빠른 시작
ReWords.AI API로 첫 이미지의 텍스트를 바꿉니다. OCR, 편집 제출, 결과 조회를 curl 요청 세 번으로.
API 키가 필요합니다. API 팩을 구매한 뒤 API 키 페이지에서 키를 만드세요(인증 참고). 셸에 설정합니다:
export REWORDS_API_KEY=rw_live_your_key1. 텍스트 찾기
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
}박스는 [x, y, 너비, 높이]이며 이미지 기준 0–1000 비율이므로 이미지의 픽셀 크기와 상관없습니다.
image_id는 24시간 동안 다시 쓸 수 있어서 이미지를 다시 업로드할 필요가 없습니다.
language에는 이미지 속 텍스트의 언어를 넣으세요(한국어는 ko, 일본어는 ja 등). 언어는 자동으로 감지되지 않으며,
지정하지 않으면 OCR은 중국어와 영어만 제대로 읽습니다(FAQ 참고).
2. 편집 제출
OCR 결과의 box를 보내거나, from과 to만 보내면 텍스트 위치를 대신 찾아 드립니다.
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에는 50% OFF에 대해 찾은 박스가 표시되고, balance에서는 편집 한 번이 이미 예약되어 있습니다.
새 작업마다 새 Idempotency-Key를 쓰고, 같은 키는 그 작업을 다시 보낼 때만 쓰세요. 다시 사용한 키는
새 편집이 아니라 이전 작업을 돌려줍니다.
3. 결과 받기
status가 succeeded 또는 failed가 될 때까지 폴링합니다. processing이거나 queued이면서 queue_position이 0이면 5초마다,
대기열에서 더 뒤에 있으면 30초마다 조회하세요. 대기열과 제한을 참고하세요.
또는 callback_url을 넘겨 웹훅을 받을 수도 있습니다.
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"
}완전한 Node.js와 Python 클라이언트, 그리고 다른 모든 응답은 예제를 보세요.
필요한 이미지는 내려받으세요. 결과는 JPEG 파일이며 공개 링크는 최소 7일 동안 유지됩니다. A, B, C가 무엇인지는 결과와 환불을, URL 대신 로컬 파일을 올리는 방법은 이미지를 보세요.