画像圧縮 API チュートリアル

MiniPic は、主要な圧縮サービスの HTTP Basic / Bearer 認証とレスポンス構造に互換性のある画像圧縮 API を提供しています。そのため多くの場合、API のエンドポイントとキーを差し替えるだけで TinyPNG などのサービスから移行できます。自社開発エンジンが PNG、JPEG、WebP を見た目の画質を損なわずに平均 60% 小さくし、毎月の無料枠があり、課金されるのは成功した圧縮のみです。エンドポイントの全リファレンスは開発者向けドキュメント（minipic.ai/docs）をご覧ください。

MiniPic の画像圧縮 API を選ぶ理由

主要な圧縮 API と互換：認証とレスポンス構造が一致 — 多くの場合、エンドポイントとキーを差し替えるだけで組み込めます。
高速、低遅延：アップロードとレスポンスが速く、サービスの呼び出しが滞りません。
毎月の無料枠：毎月 1 日にリセット — 一般的なプロジェクトを始めるには十分です。
成功した圧縮のみ課金：失敗、サイズ超過、ブロックされたリクエストには一切課金されません。

3 ステップで組み込む

ステップ 1：コンソールで API キーを作成

MiniPic のコンソールにサインインし、API キー管理へ進んでキーを作成します。キーには mp_live_（本番）/ mp_test_（サンドボックス）のプレフィックスが付きます。完全なキーは作成時に一度だけ表示されるので、安全に保管してください。

ステップ 2：最初の圧縮リクエストを送る

HTTP Basic 認証（ユーザー名は常に api、パスワードはご自身のキー）を使って画像を圧縮します：

# PNG を圧縮（Basic 認証、ユーザーは常に api） curl -s --user api:YOUR_API_KEY \ --data-binary @input.png \ -o output.png \ https://api.minipic.ai/v1/compress

ステップ 3：結果を取得してダウンロード

互換エンドポイント /shrink は 201 Created を返し、結果は暗号化されたプライベートリンクで配信され、キーの保有者であるあなただけがアクセスできます。ネイティブの /v1/compress エンドポイントは圧縮後のバイナリを直接返します。同じ結果の再ダウンロードには課金されません。

Node.js の例

// Node.js（>=18、組み込みの fetch）：ローカル画像を読み込んで圧縮 import { readFile, writeFile } from "node:fs/promises"; const key = process.env.MINIPIC_API_KEY; const auth = "Basic " + Buffer.from("api:" + key).toString("base64"); const res = await fetch("https://api.minipic.ai/v1/compress?quality=smart&format=keep", { method: "POST", headers: { Authorization: auth }, body: await readFile("input.png"), }); await writeFile("output.png", Buffer.from(await res.arrayBuffer())); console.log("圧縮完了、削減", res.headers.get("X-Ratio"));

Python の例

# Python（requests）：ローカル画像を読み込んで圧縮 import os, requests key = os.environ["MINIPIC_API_KEY"] with open("input.jpg", "rb") as f: res = requests.post( "https://api.minipic.ai/v1/compress", params={"quality": "smart", "format": "keep"}, auth=("api", key), data=f.read(), ) with open("output.jpg", "wb") as out: out.write(res.content) print("圧縮完了、削減", res.headers.get("X-Ratio"))

TinyPNG API からの移行

MiniPic は主要な圧縮サービスの認証とレスポンス構造に互換性があるため、多くの場合は API のエンドポイントとキーを差し替えるだけで、アプリケーションのコードを変えずに TinyPNG などのサービスから移行できます。ベース URL を MiniPic（minipic.ai）に向け、ご自身の MiniPic API キーに差し替えて、圧縮を始めましょう。

枠、レート制限、課金

無料枠：毎月一定回数のリクエスト、毎月 1 日にリセット。
段階制料金：月間の利用量が増えるほど 1 枚あたりの単価が下がります。
課金：課金されるのは成功した圧縮のみで、失敗、サイズ超過、ブロックされたリクエストには一切課金されません。
レート制限：キーあたり 10 req/s、バースト 20。超過すると 429 + Retry-After を返します。

エンドポイントの全リファレンスとエラーコード表は開発者向けドキュメントを、料金の段階は料金ページを、課金の詳細は請求をご覧ください。

よくある質問

MiniPic の画像圧縮 API はどのように組み込みますか？

MiniPic のコンソールで API キーを作成し、HTTP Basic 認証（ユーザー名は api、パスワードはご自身のキー）または Bearer トークンを使って圧縮エンドポイントにリクエストを送るだけです。この API は主要な圧縮サービスと認証・レスポンス構造の互換性があるため、多くの場合はエンドポイントとキーを差し替えるだけで済みます。

MiniPic の画像圧縮 API は無料ですか？

毎月の無料枠があり、毎月 1 日にリセットされます。それを超えた分は、成功した圧縮 1 枚ごとに段階制の料金で課金されます。課金されるのは成功した圧縮のみで、失敗、サイズ超過、ブロックされたリクエストには一切課金されません。

TinyPNG の API から MiniPic へ移行できますか？

はい。MiniPic の /shrink エンドポイントは主要な圧縮サービスと認証・レスポンス構造の互換性があるため、多くの場合は API のエンドポイントとキーを変更するだけで、アプリケーションのコードを変えずに移行できます。

3 ステップで組み込み、毎月の無料枠つき

API キーを作成したら、エンドポイントとキーを差し替えて圧縮を始めましょう。

API キーを作成して無料で始める →API ドキュメントの全文を見る API の料金を見る