定義済みバリアントを作成する

バリアントでは、用途ごとに画像のリサイズ方法を指定できます。デフォルトでは画像は public バリアントで配信されます。必要に応じて最大 100 個までバリアントを作成できます。次の手順でバリアントを作成します。

Cloudflare dashboard で、Hosted Images ページを開きます。
Hosted images を開く ↗
Delivery タブを選択します。
Create variant を選択します。
バリアント名を入力し、Create を選択します。
新しいバリアントの変数を定義します。リサイズオプション、フィットの種類、メタデータの扱いなどを指定します。

API でリサイズする

バリアントを作成するには、POST リクエストを送信します。

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/variants" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{"id":"<NAME_OF_THE_VARIANT>","options":{"fit":"scale-down","metadata":"none","width":1366,"height":768},"neverRequireSignedURLs":true}

フィットオプション

Fit プロパティは、幅と高さの寸法の解釈方法を表します。各オプションの動作は次の表のとおりです。

フィットオプション	動作
Scale down	指定した幅または高さに収まるよう画像を縮小します。拡大はしません。
Contain	アスペクト比を保ったまま、指定した幅または高さの範囲内で可能な限り大きくなるよう、画像を縮小または拡大します。
Cover	指定した幅と高さの領域をちょうど埋めるよう画像をリサイズします。必要に応じて切り抜きます。
Crop	指定した幅と高さの領域に収まるよう、画像を縮小して切り抜きます。拡大はしません。指定寸法より小さい画像では `scale-down` と同じです。大きい画像では `cover` と同じです。
Pad	アスペクト比を保ったまま、指定した幅または高さの範囲内で可能な限り大きくなるよう、画像を縮小または拡大します。余白は背景色（デフォルトは白）で埋めます。

メタデータオプション

バリアントでは、画像のメタデータをどう扱うかを選べます。Metadata ドロップダウンから次のいずれかを選択します。

すべてのメタデータを削除する
著作権以外のメタデータを削除する
すべてのメタデータを保持する

公開アクセス

Always allow public access をオンにすると、署名付き URL で画像を非公開にした場合でも、そのバリアントは常に公開アクセスできます。