Image optimization API

画像変換・最適化API

リサイズ、切り抜き、色調整、形式変換をリクエスト時に実行します。Face Detectionを除く画像変換パラメータを利用できます。画像の変換、最適化、配信はKuronekoServer CDNが行います。

リクエスト例

画像URLにパラメータを追加
GET /images/photo.jpg?width=800&aspect_ratio=16:9&quality=85&format=webp

200 OK
Content-Type: image/webp
Cache-Control: public, max-age=86400
X-Powered-By: KuronekoServer CDN

Package Library

パッケージの検索と、バージョンを固定したURLの確認は専用ページから利用できます。

機能

元のファイルを変更せず、同じ画像から用途に合わせたバリエーションを生成します。

リサイズと切り抜き

幅・高さ、縦横比、座標、gravity、focus cropを指定できます。

色調整とエフェクト

明度、ガンマ、コントラスト、彩度、色相、ぼかし、シャープ化などに対応します。

形式変換

JPEG、PNG、GIF、WebP、AVIF形式で出力できます。

配信キャッシュ

変換結果はKuronekoServer CDNからキャッシュ配信されます。

対応形式と制限

入力形式の一部は、利用可能な画像コーデックに依存します。

入力形式

JPEG、PNG / APNG、GIF、WebP、AVIF、BMP、TIFF、TGA、PBM、HEIC / HEIF

処理制限

  • 既定では元画像を超える拡大を行いません
  • 拡大出力は最大24メガピクセル
  • AVIF出力は最大4メガピクセル
  • 入力画像は最大50メガピクセル
  • Face Detection(face_crop)は非対応