写真修復 API とは?
ImgGen AI 写真修復 API は、傷んだ写真を修復する REST エンドポイントです。傷・裂け・しみ・色あせ・ぼけを軽減し、任意でモノクロ原版に色を加え、同じ呼び出しの中で解像度を上げることもできます。スキャン画像をアップロードすると、修復済みの画像がレスポンスで返ります。
これは ImgGen AI 画像編集 API の 7 つのエンドポイントのひとつで、いずれも同じ API キー、同じベース URL、同じリクエストとレスポンスの形式を共有しています。コードからではなくブラウザでもこの機能が必要な場合は、同じ AI モデルが Image Restoration ツールを動かしています。
リクエストパラメータ
https://app.imggen.ai/v1/image-restoration に POST リクエストを送り、Authorization ヘッダーの API キーで認証します。
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| image | file | 必須 | — | 修復しながら、モノクロ写真に写実的な色を加えます。 |
| colorize | boolean | 任意 | false | 傷・裂け・物理的な損傷を修復します。 |
| removeTears | boolean | 任意 | false | 修復後の画像をアップスケールして解像度を上げます。この呼び出しにアップスケーラーの料金が加算されます。 |
| enhanceResolution | boolean | 任意 | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
写真修復 API はどう組み込みますか?
ImgGen アカウントで API キーを作成し、環境変数に設定してエンドポイントを呼び出します。同じリクエストを cURL、Node.js、Python で示します。
curl --request POST \
--url 'https://app.imggen.ai/v1/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
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/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))レスポンス
成功した呼び出しは JSON を返します。結果は base64 エンコードされているので、ディスクやオブジェクトストレージに書き込む前にデコードしてください。成功したレスポンスにはいずれも、呼び出し後の残高を示す X-Credit-Remaining ヘッダーが付きます。
{
"success": true,
"message": "Image restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}知っておきたい制限と挙動
このエンドポイントは JPEG(JPG)、PNG、WebP を最大 25 MB のファイルサイズで受け付け、60 秒以内に同期的に応答します。ジョブをポーリングする必要も、Webhook を設定する必要もありません。
3 つの処理を 1 回で
修復・カラー化・アップスケールは別々のエンドポイントではなく同じリクエストのフラグなので、フル修復も 3 往復ではなく 1 往復で済みます。
enhanceResolution は追加料金
enhanceResolution を有効にすると、アップスケールモデルも走るため、修復の基本料金にアップスケーラーの料金が上乗せされます。
スキャン品質が効きます
モデルは見えているものから再構成します。スキャナーが対応する最高解像度で、平らに、均一な光でスキャンしたほうが、プリントをスマホで撮った画像より明らかに良い結果になります。
写真修復 API は何に使われていますか?
各チームがこのエンドポイントを本番環境に投入し、プログラムから大規模に画像を処理している場面です。
家系調査・アーカイブのプラットフォーム
修復モデルを自前で構築・ホスティングすることなく、ユーザーがアップロードした家族写真のワンクリック修復を提供できます。
デジタル化サービス
スキャンが上がってくるそばから修復を自動実行し、担当者が 1 枚ずつ編集するのではなく結果を確認するだけで済むようにします。
博物館・図書館のコレクション
劣化した写真資料から、原本には手を触れないまま、公開に耐える利用コピーを作成します。
写真プリント商品
顧客がアップロードした写真を、印刷に回す前に 1 回の呼び出しで修復・拡大します。
写真修復 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 エンドポイントです。傷・裂け・しみ・色あせ・ぼけを軽減し、任意で結果をカラー化・拡大できます。誰も手作業でレタッチすることなく、プロダクトがユーザーに修復機能を提供できるようにするためのものです。
- できます。colorize=true を指定すると、同じ修復処理の中でモデルが写実的な色を加えます。色だけが必要で写真が傷んでいないなら、専用のカラー化エンドポイントのほうが安く、より直接的です。
- 成功 1 回につき 2 クレジットです。enhanceResolution=true を指定すると 2 つ目のモデルが走るため、アップスケーラーの料金が上乗せされます。Starter は月 400 クレジットで 9.99 ドル、Pro は 1,400 クレジットで 29.99 ドル、購読を続けている限り未使用クレジットは繰り越されます。
- 傷、裂け、しみ、水濡れ、色あせ、黄変、全体的な甘さです。物理的な損傷にはとくに removeTears=true を指定してください。元の画像内容が完全に失われている領域は、復元されるのではなくもっともらしく再構成されます。モデルは推測しているのであって、取り消しているのではありません。
- その可能性はあり、ユーザーに見せる前に理解しておく価値があります。モデルは欠けた情報を推論で再構成するため、大きく傷んだ顔や解像度が非常に低い顔は、原版の人物と微妙に違って返ることがあります。見えているものからは働きますが、何も見えないところでは、もっともらしい推測を出します。出力は「修復された解釈」であって、取り戻された原版ではないものとして扱ってください。
- 1 リクエストにつき 1 枚です。このエンドポイントにバッチ形式はなく、image[] に対応しているのはウォーターマーク除去だけです。アーカイブ全体を処理するなら、ご自身のワーカーから並列にリクエストを送ってください。各リクエストは独立しており、それぞれ課金されます。
- API は 1 枚あたり最大 25 MB の JPEG(JPG)、PNG、WebP ファイルを受け付けます。結果は JSON レスポンス内に base64 エンコードされた画像として返されます。
- いいえ。この API はステートレスです。プロジェクトを作成することも、ファイルを保存することも、あなたの画像を保持することもありません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。あなたの画像がモデルの学習に使われることは一切ありません。
- はい。無料プランを含むすべてのプランに完全な商用利用権が付いており、出力にウォーターマークは一切入りません。API が返したものは自由に販売、印刷、公開できます。
はじめる
写真修復 API を呼び出してみる
キー 1 つで 7 つのエンドポイントすべてが使えます。ウォーターマークなし、完全な商用利用権付き、そして送信したものはレスポンス後に一切保存されません。
API キーを取得