画像 API

画像処理 (Image Processing)

Weekerp Image API は、URL パラメーターだけで次のような処理を提供します。

• リサイズ (width / height / size)
• フォーマット変換 (JPEG, PNG, WebP, AVIF など)
• 品質調整 (quality)
• リサイズ方式 (fit)
• 位置指定 (position)

すべての処理はリクエスト時に実行され、初回リクエスト時に変換結果が CDN エッジにキャッシュされます。
以降の同じリクエストは、キャッシュからそのまま配信されます。

キャッシュされた画像を同じパラメーターで再リクエストした場合、変換済みのキャッシュ画像がすぐに返され、遅延なく応答します。

詳しくは キャッシュ のドキュメントを参照してください。

 

基本のリクエスト形式

https://cdn.weekerp.com/image/{source}/{path/to/image}.{ext}?{options}

---

 

例

説明	リクエスト URL
幅 800px、比率は自動調整	https://cdn.weekerp.com/image/demo/photo.jpg?w=800
400×400 の正方形にリサイズ	https://cdn.weekerp.com/image/demo/photo.jpg?w=400&h=400&fit=cover
品質 70% で圧縮	https://cdn.weekerp.com/image/demo/photo.jpg?w=1200&q=70

 

オプション

オプション	別名 (Alias)	説明	例
size	size, s	width/height を一括指定	"800x600"
width	width, w	幅(px)を指定	number → 800
height	height, h	高さ(px)を指定	number → 600
format	format, f	出力フォーマットを指定	'webp', 'avif', 'jpg', 'png', 'gif', 'tiff', 'svg'
quality	quality, q	圧縮品質(1~100)	number → 80
fit	fit	リサイズ方式	'cover', 'contain', 'fill', 'inside', 'outside'
position	position, p	切り抜きの基準位置	'centre', 'top', 'bottom', 'left', 'right'

 

補足

• 元の画像は変更されません。
• 変換された画像は CDN キャッシュに保存され、同じリクエストにはすぐに配信されます。
• 既定のレスポンスフォーマットは元の拡張子に基づきます。f パラメーターを使うと WebP、AVIF などのフォーマットに変換できます。

例: https://cdn.weekerp.com/image/demo/photo.jpg?w=800&f=webp

---

 

推奨事項

• 最大レスポンスサイズは 6MB を推奨しており、最大 200MB まで変換に対応しています。
• 大きすぎる元画像は、CDN での処理中に変換が失敗することがあります。
• 必要に応じて、大容量の画像は /file エンドポイントから直接配信することを推奨します。