よくある質問
ReWords.AI API についてのよくある質問 — OCR が読めるもの、フォントと長いテキスト、テキストの削除、A と B の違い、リトライ、課金、フロントエンドからの利用、SDK、サポートへの連絡方法。
OCR
OCR はどんなテキストを読めますか？
中国語、英語、日本語、韓国語、ほとんどのヨーロッパ言語の印刷された文字です。language にテキストの主な言語を指定してください：
en、zh、ja、ko、fr、de、es、pt、it、ru。地域の部分は無視されるので、pt-BR は pt、zh-TW は zh として扱われます。
言語は自動では判定されません。language がない場合やそれ以外の値の場合、OCR は中国語と英語として読み取り（日本語もたいてい読めます）、
韓国語、キリル文字、アクセント付きのヨーロッパの文字は正しく読めません。言語がわかっている場合は、日本語も含めて必ず language を送ってください。
手書き、装飾の強いレタリング、曲がった文字や縦書きは読み取れなかったり分割されたりすることがあります。その場合は自分で box を送ってください。
texts の 1 項目とは何ですか？
1 行のテキストです。単語や段落ではありません。2 行の見出しは 2 項目として返ります。変更するには、行ごとに 1 つの置き換えを送るか、
box が両方の行を覆い、to に新しい見出し全体を入れた置き換えを 1 つ送ります。改行したい位置には \n を入れます。
テキストが画像と少し違って見えるのはなぜですか？
全角文字は半角で返ります。５０％ＯＦＦ は 50%OFF になり、全角スペースは通常のスペースになります。言語によっては小文字で返り
（フランス語、ドイツ語、ロシア語など）、単語の間のスペースが抜けることもあります：韓国語の 여름 세일 が 여름세일 として返ることがあります。
from には返されたテキストを使ってください。照合はどちらにも対応しています（下記参照）。
OCR が文字を見落とした、または読み間違えました。どうすれば？
自分で測った box を送ってください（画像を参照）。置き換えに box があると、
ボックス内のテキストが置き換えられ、from はヒントにすぎません。完全に一致する必要はありません。
OCR を呼ぶ必要はありますか？
いいえ。box なしで from と to を送れば、POST /edits が無料でテキストを見つけます。その場合は先にテキストを読み取るため、通常 5～20 秒かかります（POST /ocr と同じ）。
HTTP リクエストには少なくとも 90 秒を見込んでください。OCR は 10 個のジョブ枠を使いません。
POST /ocr を先に呼ぶのは、ユーザーにテキストを見せたい、選ばせたい、または編集の支払い前にボックスを確認したいときだけです。
from が行の一部だけの場合は？
その部分だけが変わります。50% OFF の行に from: "OFF"、to: "ON" を使うと 50% ON になります。
応答の replacements には行全体が表示されます：from: "50% OFF"、to: "50% ON"。
これらは行の OCR 読み取り結果から作られるため、小文字になったりスペースが抜けたりすることがあります（上記参照）。
新しいテキストは元の行のスタイルで描かれるので、大文字・小文字やスペースはこの文字列ではなく画像で確認してください。
照合では大文字・小文字と前後の空白を無視します。from と完全に同じ行があれば、その行だけが変わり、それを含むだけの行はそのままです。
そうでなければ、それを含むすべての行が、行内のすべての出現箇所で変わります：to が 3 なら、from: "e" で
Summer Collection は Summ3r Coll3ction になります。match: "first" は変更を 1 箇所ではなく 1 行に限定します。
正確に制御したいときは、box と新しい行全体を送ってください。どれにも一致しなければ、すべてのスペースを無視してもう一度試すので、
여름 세일 でも 여름세일 の行が見つかります。
画像にテキストがなくても OCR は課金されますか？
はい。呼び出しは "texts": [] を返し、OCR 1 回として数えます。24 時間以内の同じ画像は再び課金されません。
アラビア語、ヘブライ語、タイ語、ヒンディー語は？
対応していません。OCR がそれらの文字の行を返すことはありますが、読み取りも編集結果も保証されません。 それらで失敗したジョブは課金されません。
PDF や複数ページを一度に送れますか？
いいえ。1 つのリクエストで受け付けるのは JPEG、PNG、WebP の画像 1 枚です。変更したい各ページを画像にして、 ページごとにリクエストを送ってください。10 個のジョブ枠まで同時に実行できます。
編集
フォント、色、サイズを選べますか？
いいえ。新しいテキストは、置き換える元のテキストのフォント、色、サイズ、効果を引き継ぎます。スタイルのパラメーターはありません。
新しいテキストが長い、または短い場合は？
隣のテキストを覆わずに、元のテキストの周りのスペースに収めます。とても長いテキストは小さくなることがあります。 最も自然な結果を得るには、元の長さに近づけてください。
置き換えずにテキストを削除できますか？
はい。テキストを削除するには to を空文字列にします。背後の背景は補完されます。
from と to の長さの上限は？
それぞれ最大 200 Unicode 文字です（絵文字は 1 文字）。to の \n で改行します。from を空にできるのは box を送るときだけです。
1 回の編集でいくつ変更できますか？
画像 1 枚につき最大 20 件の置き換えで、すべて 1 つのジョブにまとめられ、編集 1 回として課金されます。同じ語が何度も出てくる場合、
match: "all"（デフォルト）はすべてを変更し、match: "first" は上から下、左から右で最初の 1 つだけを変更します。正確に選ぶには
ボックスを送ってください。同じテキストに 2 つの置き換えや重なるボックスを送らないでください。適用されるのは 1 つだけで、どれになるかは決まっていません。
応答の replacements とリクエストをどう対応づけますか？
応答には、変更された行ごとに 1 項目が、リクエストの順に並びます。box のない置き換えが 3 行に一致した場合、上から下へ 3 項目になります。
1 対 1 で対応させたい場合は、置き換えごとに box を送るか、match: "first" を使ってください。
テキスト以外のものも変えられますか？
いいえ。変わるのは指定したテキストだけです。ロゴ、顔、その他の物体は意図的に編集しません。
ジョブにはどれくらい時間がかかりますか？
通常は 1〜2 分です。10 件中 9 件は 3 分以内に、ほぼすべてが 5 分以内に終わります。応答の estimated_seconds は完了時刻の見込みです。ジョブはキューを出てから最大 10 分実行されることがあり、
キューが 30 件で満杯のときは最後のジョブに約 30 分かかることがあります。すべてのジョブは送信から 60 分以内に succeeded か failed
になります。そうならない場合はポーリングをやめ、その id を添えて [email protected] にご連絡ください。
キューと制限を参照してください。
結果
A と B のどちらを使うべきですか？
B はテキスト以外のすべてのピクセルをアップロードしたままに保ちます。商品写真、書類など、画像のほかの部分を変えてはいけないものには こちらが安全です。A は画像全体を描き直すため、新しいテキストがより自然になじむことが多い一方で、ほかの場所の細部が変わることがあります。 成功した結果はすべて（A と B、C（4K）があれば C も）ユーザーに見せて、選んでもらうことをおすすめします。
C とは何ですか？なぜスキップされたのですか？
C は 4K で生成された AI 編集で、長辺は最大 3840 px です。縦または横が 3:1 を超える画像ではスキップされ（aspect_ratio_unsupported）、
単独で失敗することもあります。C によって課金額が変わることはありません。
結果に透かしはありますか？どれくらい保存されますか？
透かしはありません。結果のリンクは img.rewords.ai 上の公開 JPEG ファイルで、少なくとも 7 日間保持されます。必要なものはダウンロードしてください。
ジョブのリンクは読み取りのたびに変わることはありません。GET /edits/{id} はリンクが保持されている間使えます。
image_id のアップロード画像は 24 時間保持されます。
結果をもう一度編集できますか？
はい。結果の url を新しい編集の image_url として渡してください。結果 B が最適な出発点です。新しいジョブとなり、
ほかと同じように課金されます。テキストを段階的に変えるときや、最初の結果にもう 1 箇所変更が必要なときに使います。
ジョブをキャンセルできますか？
いいえ、キャンセルの呼び出しはありません。ジョブが編集 1 回分の料金になるのは succeeded になったときだけです。不要になったら結果を
無視してください。送信していないジョブは費用がかからないので、送信前に POST /ocr でテキストを確認してください。
ジョブが失敗しました。どうリトライしますか？
失敗したジョブは無料です。新しい Idempotency-Key で送信し直してください。古いキーでは同じ失敗したジョブが返ります。
ai_generation_failed と upstream_failed はリトライで成功することが多いですが、content_blocked は成功しません。
課金
正確にはいつ課金されますか？
ジョブごとに編集 1 回分、A か B が成功したときだけです（もう一方が失敗していても）。送信時に編集 1 回分が確保され、
すでにキューにあるジョブが必ず完了できるようにします。ジョブが失敗すると解放されます。balance と edits_remaining からは
確保分がすでに差し引かれています。料金と請求を参照してください。
無料のテストキーやサンドボックスはありますか？
無料のテストキーはありません。rewords.ai で画像を 1 枚無料で編集して品質を確かめてから、Lite パックで始めてください。 失敗したジョブと拒否されたリクエストは課金されません。
連携
ブラウザやモバイルアプリから API を呼べますか？
いいえ。サーバーから呼んでください。API キーがフロントエンドのコードやアプリのバンドルから見えてしまい、見つけた人は誰でも あなたの残高を使えます。API は CORS ヘッダーを送らないため、ブラウザからの直接の呼び出しはブロックされます。
ポーリングと Webhook のどちらがよいですか？
どちらでも構いません。Webhook には公開された https のエンドポイントが必要で、リクエストを節約できます。ポーリングには何も要りません。
エンドポイントが停止する可能性があるなら、送信から 15 分たっても通知のないジョブは、確定するまで数分おきにポーリングもしてください。
後から届いた Webhook は問題ありません。処理済みの id をスキップするだけです。Webhookを参照してください。
ジョブを自社の注文やユーザーとどう結びつけますか？
202 応答の id をレコードと一緒に保存してください。Webhook では、保持される callback_url のクエリ文字列に独自の参照を
付けることもできます：https://example.com/hooks/rewords?order=1234。
リクエストがタイムアウトしました。ジョブは作成されましたか？
作成されたかもしれません。同じ Idempotency-Key でリトライしてください。作成されていればそのジョブが返り、二重に課金されることはありません。 エラーを参照してください。
API が予告なく変わることはありますか？
バージョンはパスにあります：/v1。/v1 の中では追加のみを行います（新しい任意のフィールド、reason や error.code の新しい値）。
知らないフィールドは無視し、未知のコードは upstream_failed と同じように扱ってください。クライアントを壊す変更は新しいバージョンにし、
古いバージョンを終了する前にメールでお知らせします。ご質問は [email protected] へ。
SDK はありますか？
まだありません。openapi.yaml をダウンロードして任意の OpenAPI 3.1 ジェネレーターでクライアントを 生成するか、サンプルにある完全な Node.js と Python のクライアントをコピーしてください。
API キーが漏れました。どうすれば？
API キーのページで無効にしてください（1 分以内に使えなくなります）。そして新しいキーを作ります。
すべてのキーは残高を共有するので、まずこれを行い、その後 GET /account を確認してください。Webhook シークレットも漏れた場合は、
同じページでリセットしてください。認証を参照してください。
created_at と completed_at のタイムゾーンは？
UTC で、Z を末尾に付けた ISO 8601 形式です：2026-11-04T10:00:00Z。
サポート
[email protected] にご連絡いただくか、 お問い合わせページから WhatsApp や TikTok をご利用ください。API についての質問はメールが最も早く届きます。
リクエストを特定できる情報を添えてください：
- ジョブの
id（edit_...）またはimage_id、そしてリクエストの UTC 時刻 - 使ったキーの最初の 12 文字（
rw_live_abcd...）。キー全体は絶対に送らないでください - 受け取った
error.codeとmessage、またはおかしいと思われる結果 - 共有できる場合は画像と、送った
replacements
請求に関する質問では、購入を確認できるよう rewords.ai アカウントのメールアドレスもお知らせください。