画像アップスケーリングAPI：開発者向け統合ガイド

アプリに画像アップスケーリングを組み込むのは、以前なら大変な作業でした。自前でAIモデルを訓練して、何ヶ月もかけて、GPU予算もかなり必要でした。UpscaleIMG APIなら、画像を送るだけ。数秒でシャープに拡大された画像が返ってきます。

このガイドでは、UpscaleIMGをプロジェクトに組み込む方法を紹介します。実際のコード例とすべてのオプション付きです。

UpscaleIMG APIで何ができる？

UpscaleIMG APIはReal-ESRGANを使っています。画像超解像に特化した強力なAIモデルです。写真を送ると、AIが拡大しながらリアルなディテールを追加してくれます。エッジはシャープなまま。テクスチャは自然。顔の特徴もしっかり保持されます。

主な機能：

• 2倍・4倍アップスケーリング AIによる詳細な画質向上
• カスタムサイズ 特定の出力サイズを指定可能
• フォーマット変換 PNG、JPG、WebP間で変換
• メタデータ制御 EXIFデータの削除・保持を選択
• 最大6,400万画素 の出力解像度

AI処理はすべてサーバー側で実行されます。あなたの環境にGPUは不要。モデルのセットアップもいりません。HTTPリクエストを送って結果を受け取るだけです。

APIを使い始めるには？

リクエストにはAPIキーが必要です。取得はかんたん：

1. upscaleimg.app でアカウントを作成
2. ダッシュボードでAPIキーを生成
3. サーバー側で安全に保管

APIエンドポイント：

POST https://upscaleimg.app/api/v1/upscale

認証はAuthorizationヘッダーのBearerトークンで行います。APIキーはサーバー側で管理してください。クライアントコードに公開したり、リポジトリにコミットするのはNGです。

無料アカウントでは2倍アップスケーリングが使えます。有料プランにすると、4倍アップスケーリングと元画像の最大4倍までのカスタムサイズが解放されます。

最初の画像をアップスケーリングしてみよう

一番シンプルな呼び出しは、画像とスケールファクターだけ。curlで2倍にする例はこちら：

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "scale=2"

APIは元画像とアップスケール後の画像の詳細をJSONで返します：

{
  "original": {
    "size": 384000,
    "width": 1920,
    "height": 1080,
    "mimeType": "image/jpeg",
    "fileExt": "jpg"
  },
  "result": {
    "size": 1280000,
    "width": 3840,
    "height": 2160,
    "mimeType": "image/png",
    "fileExt": "png",
    "url": "https://..."
  }
}

urlフィールドに署名付きダウンロードリンクが入っています。署名付きURLは短時間で期限切れになるので、すぐにダウンロードしてください。

JavaScriptならこう：

const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('scale', '2');

const response = await fetch('https://upscaleimg.app/api/v1/upscale', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: form
});

const data = await response.json();
console.log(`${data.result.width}x${data.result.height}に拡大`);

Pythonならこう：

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://upscaleimg.app/api/v1/upscale',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'image': f},
        data={'scale': '2'}
    )

data = response.json()
print(f"{data['result']['width']}x{data['result']['height']}に拡大")

どんなオプションがある？

APIはマルチパートフォームデータで複数のパラメータを受け付けます。全一覧はこちら：

パラメータ	必須	値	説明
image	はい	ファイル	PNG、JPG、JPEG、WebP画像
scale	はい*	2または4	拡大倍率。*カスタムサイズ使用時は不要。
customWidth	いいえ	整数	目標幅（ピクセル、最大4倍）
customHeight	いいえ	整数	目標高さ（ピクセル、最大4倍）
objectFit	いいえ	cover, contain, fill	カスタムサイズ時のフィットモード。デフォルト：cover。
outputFormat	いいえ	jpg, jpeg, png, webp	出力フォーマット。デフォルト：png。
removeMetadata	いいえ	1または0	EXIFデータを削除。デフォルト：0（保持）。

カスタムサイズを使えば、出力を細かくコントロールできます。customWidthとcustomHeightは必ずセットで指定します。出力は元画像より小さくできず、4倍を超えることもできません（無料アカウントは2倍まで）。

たとえば、3000x2000のWebPに拡大するなら：

curl -X POST https://upscaleimg.app/api/v1/upscale \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "customWidth=3000" \
  -F "customHeight=2000" \
  -F "objectFit=cover" \
  -F "outputFormat=webp" \
  -F "removeMetadata=1"

エラーとレート制限への対応は？

APIは標準的なHTTPステータスコードを返します：

ステータス	意味
200	成功。拡大画像が返されました。
400	不正なリクエスト。画像がない、無効な倍率、サイズ範囲外など。
401	APIキーが無効または未指定。
403	禁止。サブスクなしで4倍を試行、またはCORSエラー。
429	レート制限。リクエストが多すぎます。
500	サーバーエラー。再試行してください。

エラーレスポンスにはメッセージが含まれます：

{"error": "4x upscaling is only available with an active subscription."}

レート制限に引っかかったら、バックオフ付きのリトライロジックを入れておくと安心です：

async function upscaleWithRetry(form, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const res = await fetch('https://upscaleimg.app/api/v1/upscale', {
      method: 'POST',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
      body: form
    });

    if (res.status === 429) {
      await new Promise(r => setTimeout(r, 2000 * (i + 1)));
      continue;
    }

    return await res.json();
  }
  throw new Error('Max retries reached');
}

どんなユースケースに向いている？

UpscaleIMG APIはさまざまなワークフローにフィットします。

ECサイトでは、出品者の商品写真を改善するのに使われています。アップロードされる画像は小さかったり低品質だったりすることが多いもの。自動アップスケーリングで、すべての出品が見栄え良くなります。画質を落とさず拡大する方法も参考にどうぞ。

オンデマンド印刷サービスには高解像度ファイルが欠かせません。お客さんがアップロードする画像は画面では綺麗でも、印刷には小さすぎることがよくあります。4Kまで拡大することも可能です。

写真修復アプリではアップスケーリングと他の画像改善を組み合わせて使います。古い写真やぼやけた写真をシャープにしながら拡大できます。

CMSならアップロード時に画像を自動で改善。すべての画像が最低限の品質基準をクリアするようになります。

不動産サイトでは写真の品質を統一するのに役立ちます。いろんなカメラで撮られた写真でも、アップスケーリングでプロっぽい仕上がりに。

バッチ処理については、画像アップスケーリングの自動化ガイドをチェックしてみてください。アップスケーラーの比較も参考になります。

さっそく始めてみよう

1時間もあれば動く統合が完成します。upscaleimg.appでアカウントを作って、APIキーを取得して、最初のテスト画像を送ってみましょう。

まずは2倍で何枚かテストして品質を確認。良さそうなら、パイプラインに組み込みましょう。画像拡大の完全ガイドで、AIアップスケーリングについてもっと詳しく学べます。

無料プランでテストやPoC構築ができます。4倍アップスケーリングやもっと多くの処理が必要になったら、有料プランへどうぞ。