画像アップスケール API とは?
ImgGen AI 画像アップスケール API は、単純な補間ではなく AI で画像の解像度を高める REST エンドポイントです。ピクセルを引き伸ばすのではなく輪郭・質感・細部を再構成するため、出力は鮮明なままです。画像と拡大倍率を送ると、より高解像度の結果が同じリクエストの中で返ります。
これは ImgGen AI 画像編集 API の 7 つのエンドポイントのひとつで、いずれも同じ API キー、同じベース URL、同じリクエストとレスポンスの形式を共有しています。コードからではなくブラウザでもこの機能が必要な場合は、同じ AI モデルが AI Image Upscaler ツールを動かしています。
リクエストパラメータ
https://app.imggen.ai/v1/upscale-image に POST リクエストを送り、Authorization ヘッダーの API キーで認証します。
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| image | file | 必須 | — | 拡大倍率。2 または 4 を指定できます。 |
| factor | number | 任意 | 4 | 顔の再構成を追加で行います。ポートレートや集合写真に有効です。 |
| enhanceFace | boolean | 任意 | false | アップスケール後の結果にシャープ化を追加します。 |
| sharpen | boolean | 任意 | false | 出力形式。jpeg または png を指定できます。 |
| output | string | 任意 | jpeg | Output format. Accepts jpeg or png. |
画像アップスケール API はどう組み込みますか?
ImgGen アカウントで API キーを作成し、環境変数に設定してエンドポイントを呼び出します。同じリクエストを cURL、Node.js、Python で示します。
curl --request POST \
--url 'https://app.imggen.ai/v1/upscale-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form factor=4 \
--form enhanceFace=false \
--form sharpen=false \
--form output=jpegimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');
const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
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/upscale-image",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
)
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 upscaled successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}知っておきたい制限と挙動
このエンドポイントは JPEG(JPG)、PNG、WebP を最大 25 MB のファイルサイズで受け付け、60 秒以内に同期的に応答します。ジョブをポーリングする必要も、Webhook を設定する必要もありません。
出力形式を選べます
可逆な結果が必要なとき、あるいはアルファチャンネルを残したいときは output=png を指定してください。大量のカタログ処理では jpeg のほうがペイロードを小さく保てます。
顔の補正はオプトイン
enhanceFace は顔の再構成を追加で行い、ポートレートを補正しつつ拡大します。顔のない商品写真や風景ではオフのままにしてください。
Synchronous by design
There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.
画像アップスケール API は何に使われていますか?
各チームがこのエンドポイントを本番環境に投入し、プログラムから大規模に画像を処理している場面です。
旧カタログの移行
撮り直す代わりに、長年たまった小さく解像度の低い商品画像を、バッチ処理で今どきの高解像度表示に耐える水準まで引き上げます。
印刷用の準備
Web 用の素材を印刷に耐えるサイズまで引き上げ、同じ呼び出しの中で任意にシャープ化してより鮮明に仕上げます。
ユーザー投稿コンテンツ
小さなアバターやアップロード画像をサーバー側で拡大し、高精細ディスプレイでもきれいに表示されるようにします。
メディアとアーカイブ
スキャン画像や圧縮された元画像を、コンテンツ管理システムに入る前に高解像度化します。必要に応じて修復も併せて行えます。
画像アップスケール API の料金は?
成功した呼び出し 1 回につき 2–4クレジット かかるため、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 エンドポイントです。リサイズのように既存のピクセル間を補間するのではなく、その画像の高解像度版が持つはずの細部(輪郭・質感・構造)をモデルが予測して再構成します。画像を POST し、拡大された結果をレスポンスから読み取ります。
- factor パラメータは 2 または 4 を受け付け、既定値は 4 です。入力は最大 25 MB の JPEG(JPG)・PNG・WebP、出力は jpeg(既定)または png で返せます。
- 料金は倍率に連動します。factor=2 なら 2 クレジット、factor=4(既定値)なら 4 クレジットです。Starter は月 400 クレジットで 9.99 ドル、Pro は 1,400 クレジットで 29.99 ドル、購読を続けている限り未使用クレジットは繰り越されます。クレジット制なので、処理量の多い月も静かな月も 1 枚あたりの費用は同じです。
- アップスケールは拡大しながら細部を再構成するので、副次的に甘い画像が引き締まりますし、sharpen フラグでその効果をさらに強められます。傷んだ写真や色あせた写真(傷・裂け・退色)には、解像度ではなく修復のために作られた写真修復 API をお使いください。
- 同期です。ポーリングするジョブ ID も、設定する Webhook もありません。アップスケール済みの画像は同じレスポンスのボディに入っており、1 リクエストあたり 60 秒の上限があります。
- はい。無料プランを含むすべてのプランに完全な商用利用権が付いており、出力にウォーターマークは一切入りません。API が返したものは自由に販売、印刷、公開できます。
- いいえ。この API はステートレスです。プロジェクトを作成することも、ファイルを保存することも、あなたの画像を保持することもありません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。あなたの画像がモデルの学習に使われることは一切ありません。
はじめる
画像アップスケール API を呼び出してみる
キー 1 つで 7 つのエンドポイントすべてが使えます。ウォーターマークなし、完全な商用利用権付き、そして送信したものはレスポンス後に一切保存されません。
API キーを取得