テキスト除去 API とは？
ImgGen AI テキスト除去 API は、画像内のテキストを見つけて除去し、文字があった場所の背景を再構成する REST エンドポイントです。マスクなしで字幕・テロップ・タイムスタンプ・焼き込まれたラベルを扱えます。モデルがテキストを見つけられない場合、リクエストは 422 を返し、クレジットは差し引かれません。
これは ImgGen AI 画像編集 API の 7 つのエンドポイントのひとつで、いずれも同じ API キー、同じベース URL、同じリクエストとレスポンスの形式を共有しています。コードからではなくブラウザでもこの機能が必要な場合は、同じ AI モデルが Image Text Remover ツールを動かしています。
リクエストパラメータ
https://app.imggen.ai/v1/remove-text に POST リクエストを送り、Authorization ヘッダーの API キーで認証します。
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| image | file | 必須 | — | The image to clean. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
画像テキスト除去 API はどう組み込みますか？
ImgGen アカウントで API キーを作成し、環境変数に設定してエンドポイントを呼び出します。同じリクエストを cURL、Node.js、Python で示します。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-text' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-text', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-text",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))レスポンス
成功した呼び出しは JSON を返します。結果は base64 エンコードされているので、ディスクやオブジェクトストレージに書き込む前にデコードしてください。成功したレスポンスにはいずれも、呼び出し後の残高を示す X-Credit-Remaining ヘッダーが付きます。
{
"success": true,
"message": "Text removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}知っておきたい制限と挙動
このエンドポイントは JPEG（JPG）、PNG、WebP を最大 25 MB のファイルサイズで受け付け、60 秒以内に同期的に応答します。ジョブをポーリングする必要も、Webhook を設定する必要もありません。
テキストがなければ課金なし
モデルが画像内にテキストを検出しない場合、エンドポイントは 422 VALIDATION_ERROR を返し、何も差し引きません。混在した画像群にそのまま流しても、もともときれいな画像の分を支払う必要はありません。
ぼかしではなく生成的な埋め戻し
文字の背後の領域は、にじませるのではなく周囲になじむように再構成されるため、細部の多い背景でも結果が破綻しません。
自動検出
領域やバウンディングボックスのパラメータはありません。モデル自身がテキストを見つけるからこそ、このエンドポイントは無人で走らせても安全です。
画像テキスト除去 API は何に使われていますか？
各チームがこのエンドポイントを本番環境に投入し、プログラムから大規模に画像を処理している場面です。
ローカライズのパイプライン
マーケティング画像から焼き込まれた原語のコピーを取り除き、市場ごとにローカライズ版を合成できるようにします。
マーケットプレイス出品の品質管理
出品者が商品写真に足した宣伝テロップや競合ブランドの表示を取り除き、カタログの規約を自動的に適用します。
アーカイブの整理
スキャン画像や古い写真に焼き込まれたタイムスタンプやカメラのラベルを、メディアライブラリに入る前に消しておきます。
テンプレートの再利用
完成したクリエイティブからきれいなベース画像を取り戻し、同じデザインに新しいコピーを載せられるようにします。
画像テキスト除去 API の料金は？
成功した呼び出し 1 回につき 2クレジット かかるため、1 枚あたりの実質コストはご利用のプランによって決まります。クレジットはプランから消費され、すべてのエンドポイントと Web エディターで共通なので、ツールごとに別枠を購入する必要はありません。失敗した呼び出しは自動的に返金されます。詳細は料金ページをご覧ください。
| プラン | 料金 | クレジット | API |
|---|---|---|---|
| Free | $0 | 無料クレジット 50（一度限り） | API アクセスなし |
| Starter | $9.99 / month | 月 400 クレジット | API アクセス込み |
| Pro | $29.99 / month | 月 1,400 クレジット | API アクセス + 優先サポート |
| Enterprise | Custom | カスタム量 | 専有インフラ |
クレジット料金と制限の最終確認日 2026-08-27.
関連するエンドポイントとツール
画像テキスト除去 API を使っているチームが、次に手を伸ばすことが多いのはこちらです。
テキスト除去 API のよくある質問
- 写真の中の文字を検出して消し、その背後に隠れていた背景を埋め戻す HTTP エンドポイントです。エディターで手作業のスタンプツールを使って文字を消すのと同じことを、1 秒で、しかも領域を人が指定することなく行います。
- リクエストは VALIDATION_ERROR コード付きの HTTP 422 を返し、クレジットは課金されません。そのため、混在したバッチに対して念のため走らせても安全です。実際にテキストがあった画像の分だけ支払うことになります。
- まさにこのエンドポイントがそれを行います。文字の上から塗りつぶすのではなく、テキスト領域を検出して取り除き、周囲のピクセルを手がかりに隠れていた背景を再構成します。テキスト領域の外側は一切手を加えないので、写真の残りの部分は送信したものとビット単位で同一です。
- はい。検出は画像全体に及ぶため、見つかったテキスト領域（字幕、隅のタイムスタンプ、中央のラベル）はすべて同じ 1 回の呼び出しで除去されます。なお、複数の*画像*を 1 リクエストにまとめることはここでは対応していません。1 リクエストにつき 1 枚を送るか、バッチアップロードが必要ならウォーターマークのエンドポイントをお使いください。
- テキスト領域の外側では落ちません。そのピクセルは手を加えられずに通過します。領域の内側は復元ではなく生成なので、込み入った背景や細部の多い背景は、平坦な背景より再構成が難しくなります。出力解像度は入力と同じで、縮小は行いません。
- それには専用のウォーターマーク除去エンドポイントをお使いください。透かしに多い半透明・反復・タイル状のオーバーレイに合わせて調整されており、バッチアップロードを受け付ける唯一のエンドポイントでもあります。こちらは不透明なテキスト、つまり字幕・タイムスタンプ・焼き込まれたラベルを対象としています。
- 成功 1 回につき 2 クレジット、テキストが検出されなかった場合はまったく課金されません。Starter は月 400 クレジットで 9.99 ドル、Pro は 1,400 クレジットで 29.99 ドル、購読中は未使用クレジットが繰り越されます。
- できません。検出は自動で、画像全体が対象です。領域やバウンディングボックスのパラメータはありません。選択的に消したい場合は、ImgGen の Web エディターにブラシ式のオブジェクト除去ツールがあり、そうした手作業向けの用途に適しています。
- API は 1 枚あたり最大 25 MB の JPEG（JPG）、PNG、WebP ファイルを受け付けます。結果は JSON レスポンス内に base64 エンコードされた画像として返されます。
- いいえ。この API はステートレスです。プロジェクトを作成することも、ファイルを保存することも、あなたの画像を保持することもありません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。あなたの画像がモデルの学習に使われることは一切ありません。
はじめる
テキスト除去 API を呼び出してみる
キー 1 つで 7 つのエンドポイントすべてが使えます。ウォーターマークなし、完全な商用利用権付き、そして送信したものはレスポンス後に一切保存されません。
API キーを取得