本番環境向け

画像最適化 API

1 回の同期 API リクエストで画像を圧縮、リサイズ、変換。成功した画像にのみクレジットを使用します。

同期式でシンプル

デフォルトの store=none は画像バイト列を同期応答で返し、入力画像や出力画像を永続保存しません。

store=temp / store=cdn

store=temp は最適化結果のみを保存し、2時間有効なダウンロードリンクを含む JSON を返します。リンクの失効と物理的削除は別であり、削除はストレージのライフサイクルクリーンアップに従います。固定の削除期限は保証しません。 store=cdn は公開 URL を含む JSON を返し、ユーザーによる削除、規約の適用、またはプラン・サブスクリプションのライフサイクルクリーンアップまで最適化結果のみを保存します。

予測しやすいクレジット

正常に処理された画像 1 枚につき 1 クレジットです。検証、デコード、処理の失敗にはクレジットがかかりません。

1 つのエンドポイント、便利な設定

  • JPEG、PNG、WebP、HEIC、HEIF を入力できます。
  • JPEG、PNG、WebP、AVIF で出力できます。HEIC では出力しません。
  • 品質、最大幅、最大高さ、メタデータを設定できます。
  • 20 MB、25 メガピクセル、1 フレーム、30 秒の安全上限があります。
  • 任意の Idempotency-Key ヘッダーで同じ結果を保証する再試行ができます。
curl -X POST "$API_URL/v1/images/optimize" \
  -H "Authorization: Bearer oyi_live_..." \
  -H "Idempotency-Key: upload-123" \
  -F "[email protected]" \
  -F "output_format=webp" \
  -F "quality=80" \
  --output photo.webp

毎月500クレジット無料

サブスクリプションのないアカウントには毎月500クレジットを無料で付与し、さらに初回限定で100クレジットのウェルカムボーナスが付きます。カードは不要です。正常に処理された画像は1クレジット、失敗したリクエストは無料です。

無料のAPIアカウントを作成