v1 · 7 エンドポイント · 稼働中
画像編集
API を開発者に
API キー 1 つの向こうに、7 つの AI 画像処理エンドポイント。背景除去、アップスケール、ウォーターマークとテキストの除去、修復、カラー化、そしてテキストからの画像生成。素の REST、JSON レスポンス、呼び出しが終われば何も残りません。
- 7 エンドポイント、キー 1 つ
- HTTPS 上の REST
- ウォーターマークなし
- 何も保存しない
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}ImgGen AI 画像編集 API とは？
ImgGen AI 画像編集 API は、AI による画像処理をオンデマンドで実行する REST サービスです。画像（またはテキストプロンプト）を HTTPS でエンドポイントに送ると、処理結果が JSON レスポンス内に base64 エンコードされて返ってきます。ホストするモデルも、用意する GPU もありません。
すべてのエンドポイントが同じベース URL、同じ API キー、同じレスポンス形式を共有しているため、ワークフローに 2 つ目の機能を足すのはパスを変えるだけで、新しい統合作業にはなりません。コードを書く前にモデルを試したい場合は、ブラウザで動く ImgGen AI の無料ツール が同じモデルを使っています。
画像編集 API はどう使いますか？
API キーを生成し、画像を添えてマルチパートリクエストを送ります。この例では背景を除去していますが、ほかの編集系エンドポイントもパスが違うだけで同じ形です。画像生成だけは例外で、ファイルではなくプロンプト・サンプル数・アスペクト比を含む JSON ボディを受け取ります。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--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-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))7 つのエンドポイント
それぞれにパラメータ、3 言語のコード例、正確なクレジット料金を載せたリファレンスページがあります。
背景除去 API
POST リクエスト 1 つで、プログラムから画像の背景を除去します。API キー 1 つ、透過 PNG 出力、そして送信した画像を決して保存しないステートレスなサービス。
画像アップスケール API
自社のバックエンドから画像の解像度を 2 倍・4 倍に引き上げます。顔の補正とシャープ化は任意、出力は JPEG か PNG、そして料金は指定した倍率に応じて変わります。
ウォーターマーク除去 API
1 回のリクエストで画像内の透かしを検出して消します。生成的インペインティングが透かしの下のピクセルを再構成し、しかもこれは画像のバッチも受け付ける唯一のエンドポイントです。
テキスト除去 API
字幕・テロップ・タイムスタンプ・焼き込まれたラベルを、プログラムから画像に対して消去します。検出は自動で、画像にテキストがなければ課金されません。
写真修復 API
古く、傷み、色あせた写真を自社バックエンドから修復します。3 回の呼び出しをつなぐ代わりに、同じリクエストの中で任意にカラー化と高解像度化も行えます。
写真カラー化 API
1 回のリクエストで、モノクロ写真を自然な色合いの画像に変えます。同じ呼び出しで任意に裂けの修復もでき、色を手で選ぶ工程はどこにもありません。
AI 画像生成 API
1 回の JSON リクエストで、テキストプロンプトから画像を生成します。1 回の呼び出しで最大 4 サンプル、速度と品質を選べる 3 つのモデル、そして出力には完全な商用利用権が付きます。
画像編集 API の料金は？
課金は呼び出しごとの定額ではなくクレジット制なので、忙しい月も静かな月も 1 枚あたりの費用は同じです。クレジットはすべてのエンドポイントと Web エディターで共通です。ツールごとに別枠があるのではなく、残高は 1 つだけ。失敗した呼び出しは自動的に返金され、成功したレスポンスはすべて X-Credit-Remaining ヘッダーで残高を返します。
| エンドポイント | パス | クレジット / 呼び出し |
|---|---|---|
| 背景除去 | /v1/remove-background | 1 |
| 画像アップスケール | /v1/upscale-image | 2–4 |
| ウォーターマーク除去 | /v1/remove-watermark | 2 |
| テキスト除去 | /v1/remove-text | 2 |
| 写真修復 | /v1/image-restoration | 2 |
| 写真カラー化 | /v1/colorize-photo | 2 |
| 画像生成 | /v1/generate-image | 3+ |
| プラン | 料金 | クレジット | API | 備考 |
|---|---|---|---|---|
| Free | $0 | 無料クレジット 50（一度限り） | API アクセスなし | クレジットカード不要 |
| Starter | $9.99 / month | 月 400 クレジット | API アクセス込み | 未使用クレジットは繰り越し |
| Pro | $29.99 / month | 月 1,400 クレジット | API アクセス + 優先サポート | 未使用クレジットは繰り越し |
| Enterprise | Custom | カスタム量 | 専有インフラ | support@imggen.ai |
クレジット料金と制限の最終確認日 2026-08-27. 詳細は料金ページをご覧ください。
API の仕組み
あえて退屈に。リクエスト 1 つ、レスポンス 1 つ、あなたの側にオーケストレーションは不要です。
同期、キューなし
処理済みの画像は同じレスポンスのボディに入っています。ポーリングするジョブ ID も、立てる Webhook エンドポイントも、突き合わせるキューもありません。リクエストには 60 秒の上限があります。
入力はマルチパート、出力は base64
入力画像はマルチパートフォームで送ります。JPEG（JPG）、PNG、WebP、最大 25 MB。結果は JSON ボディ内に base64 エンコードで返るので、デコードして保存先に書き込んでください。
成功したときだけ課金
クレジットはアトミックに引き落とされ、処理が失敗すると自動的に返金されるため、実際に返ってきた画像の分しか請求されません。テキスト除去は、消すべき文字がないときは 422 を無料で返しさえします。
ローテーションできるキー
キーは一度しか表示されず、ハッシュとしてのみ保存されます。失効はおよそ 1 分で行き渡るので、キーの漏洩は「1 分の問題」であってインシデントではありません。
API は私の画像を保存したり学習に使ったりしますか？
いいえ。 この API はステートレスです。あとで作業を再開できるようプロジェクトを保存する Web エディターとは違い、API 呼び出しはプロジェクトもタスク記録も保存ファイルも作りません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。
あなたの画像がモデルの学習に使われることは一切ありません。契約上保持できない顧客の写真を扱っている場合、これは重要です。それらを当社のストレージの外に留めているのは、方針だけでなくアーキテクチャそのものです。
エラーレスポンス
失敗時は次の形の JSON が返ります { "error": { "message", "code" } }。HTTP ステータスはその code に対応します。
| ステータス | コード | 意味 |
|---|---|---|
| 401 | UNAUTHORIZED | API キーがない、形式が不正、または失効しています。 |
| 402 | INSUFFICIENT_CREDITS | この呼び出しに必要なクレジットがアカウントに足りません。 |
| 403 | FORBIDDEN | ご利用のプランではこのツールにアクセスできません。 |
| 404 | NOT_FOUND | そのエンドポイントのパスは存在しません。 |
| 409 | CONFLICT | リクエストがリソースの現在の状態と競合しています。 |
| 422 | VALIDATION_ERROR | リクエストが拒否されました。ファイル形式が不正、必須フィールドがない、または処理対象がありません。クレジットは請求されません。 |
ImgGen API は誰が使っていますか？
画像処理 API がプロダクトの中で本当に効いてくる場面です。
EC とマーケットプレイス
仕入先や出品者の画像をアップロード時点で揃えます。背景を切り抜き、重なった文字を取り除き、解像度の低い古い写真を拡大すれば、どの商品ページも同じスタジオで撮ったように見えます。
オンデマンド印刷と製品モックアップ
デザインを切り出し、印刷品質まで解像度を上げ、テンプレートに合成します。デザイナーが一件ずつ手を入れる必要はありません。
デザイン・編集系 SaaS
GPU をホストせず、モデルをファインチューニングせず、推論基盤を維持することもなく、自社プロダクトにワンクリック編集機能を実装できます。
アーカイブ、家系調査、デジタル化
スキャンした写真を 1 枚ずつ手作業でレタッチする代わりに、自動パイプラインで修復・カラー化・拡大します。
コンテンツ・出版プラットフォーム
プロンプトからオリジナル画像を生成し、既存の編集ワークフローの中で寄稿者のアップロード画像を整えます。
制作会社と社内ツール
クライアントのブリーフから完成物までの間にある反復的な画像作業を、チームがすでに使っているツールから自動化します。
画像編集 API のよくある質問
- あります。ImgGen AI 画像編集 API は 7 つの REST エンドポイント（背景除去、画像アップスケール、ウォーターマーク除去、テキスト除去、写真修復、カラー化、テキストからの画像生成）を提供しており、すべて https://app.imggen.ai 上にあり、1 つの API キーで利用できます。
- 送信した画像に対して特定の編集を行い、その結果を同じレスポンスで返します。背景を除去して透過 PNG を得る、2 倍や 4 倍に拡大する、ウォーターマークや焼き込まれた文字を消す、傷んだ写真を修復してカラー化する、テキストプロンプトから新しい画像を生成する、といったことが可能です。
- https://editor.imggen.ai で ImgGen アカウントを作成し、アカウント設定からキーを生成します。キーは一度しか表示されずハッシュとしてのみ保存されるため、安全な場所にコピーしてください。紛失した場合は復元ではなく再発行になります。キーの失効はおよそ 1 分以内に反映されます。
- すべてのリクエストで、キーをベアラートークンとして送信します：Authorization: Bearer sk_live_…。現行方式より前に発行されたキーは、引き続き受け付けている従来の x-imggen-key ヘッダーでも認証できます。
- 利用量は呼び出しごとの定額ではなくクレジットで測られ、料金はエンドポイントによって異なります。背景除去は 1 クレジット、ウォーターマーク除去・テキスト除去・修復・カラー化は 2 クレジット、アップスケールは factor=2 で 2、factor=4 で 4、画像生成は 3 から始まりモデルによって変わります。Starter は月 400 クレジットで 9.99 ドル、Pro は 1,400 クレジットで 29.99 ドル、購読中は未使用クレジットが繰り越されます。
- 無料の ImgGen アカウントにはクレジットカード不要で 50 クレジットが付き、Web ツールでモデルを評価するには十分です。API アクセス自体は有料の Starter・Pro プランに含まれます。恒久的な無料 API 枠は存在せず、あとから静かに制限をかけるものを宣伝するより、はっきりそう申し上げます。
- API は 1 枚あたり最大 25 MB の JPEG（JPG）、PNG、WebP ファイルを受け付けます。結果は JSON レスポンス内に base64 エンコードされた画像として返されます。
- 同期です。ポーリングするジョブ ID も、管理するキューも、設定する Webhook もありません。処理済みの画像は同じレスポンスのボディに入っています。リクエストには 60 秒の上限があります。
- いいえ。この API はステートレスです。プロジェクトを作成することも、ファイルを保存することも、あなたの画像を保持することもありません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。あなたの画像がモデルの学習に使われることは一切ありません。
- はい。無料プランを含むすべてのプランに完全な商用利用権が付いており、出力にウォーターマークは一切入りません。API が返したものは自由に販売、印刷、公開できます。
- ウォーターマーク除去エンドポイントは image[] でまとめて送られたファイルを受け付け、images 配列を返します。ほかのエンドポイントは 1 リクエストにつき 1 枚です。量をこなすには、各呼び出しが独立しているので、ご自身のワーカーから並列にリクエストを送ってください。
- 現時点ではありません。この API は HTTPS 上の素の REST とマルチパートアップロードなので、どの HTTP クライアントでも使えますし、ドキュメントには cURL・Node.js・Python のコピーしてすぐ使える例があります。公式クライアントライブラリも、公開された OpenAPI 仕様も、まだありません。
はじめる
最初の呼び出しは 5 分で
キーを作り、cURL の例をコピーすれば、背景除去はもう動いています。キー 1 つで 7 つのエンドポイントすべてを、API アクセスを含むすべてのプランでカバーします。
API キーを取得