コンテンツにスキップ

バリアントの作成

バリアントを使用すると、異なる使用ケースに応じて画像のリサイズ方法を指定できます。デフォルトでは、画像は public バリアントで提供されますが、ニーズに応じて最大100のバリアントを作成できます。バリアントを作成するには、以下の手順に従ってください。

  1. Cloudflareダッシュボード ↗にログインし、アカウントを選択します。
  2. Images > Variantsを選択します。
  3. バリアントに名前を付け、Add New Variantを選択します。
  4. 新しいバリアントのための変数を定義します。リサイズオプション、フィットの種類、特定のメタデータオプションなどを含みます。

APIを介したリサイズ

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

Terminal window
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と同じです。指定された寸法より大きい画像の場合、これはcoverと同じです。
パッド画像はアスペクト比を保持しながら、指定された幅または高さ内で可能な限り大きく（縮小または拡大）リサイズされます。余分な領域は背景色（デフォルトは白）で埋められます。

メタデータオプション

バリアントを使用すると、画像のメタデータ情報に対して何をするかを選択できます。Metadataドロップダウンから選択してください：

  • すべてのメタデータを削除
  • 著作権を除くすべてのメタデータを削除
  • すべてのメタデータを保持

公開アクセス

Always allow public accessオプションが選択されている場合、特定のバリアントは常に公開アクセス可能であり、画像がsigned URLsを使用してプライベートにされている場合でもアクセスできます。

Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings