变体让您指定图像应如何为不同用例调整大小。默认情况下,图像以 public 变体提供,但您可以创建最多 100 个变体以满足需求。按照以下步骤创建变体。
-
在 Cloudflare 仪表板中,转到 Hosted Images(托管图像) 页面。
Go to Hosted images ↗ -
选择 Delivery(交付) 标签。
-
选择 Create variant(创建变体)。
-
命名变体并选择 Create(创建)。
-
为新变体定义变量,例如调整大小选项、fit 类型和特定元数据选项。
发出 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 属性描述应如何解释宽度和高度尺寸。下表描述每个选项。
| Fit 选项 | 行为 |
|---|---|
| Scale down | 图像缩小以完全适应给定的宽度或高度,但不会放大。 |
| Contain | 图像调整大小(缩小或放大)以在给定宽度或高度内尽可能大,同时保持宽高比。 |
| Cover | 图像调整大小以完全填充 width 和 height 指定的整个区域,必要时会被裁剪。 |
| Crop | 图像缩小并裁剪以适应 width 和 height 指定的区域。图像不会被放大。对于小于给定尺寸的图像,与 scale-down 相同。对于大于给定尺寸的图像,与 cover 相同。 |
| Pad | 图像调整大小(缩小或放大)以在给定宽度或高度内尽可能大,同时保持宽高比。额外区域用背景色填充(默认为白色)。 |
变体允许您选择如何处理图像的元数据信息。从 Metadata(元数据) 下拉菜单中选择:
- Strip all metadata(剥离所有元数据)
- Strip all metadata except copyright(剥离除版权外的所有元数据)
- Keep all metadata(保留所有元数据)
选择 Always allow public access(始终允许公开访问) 选项时,特定变体将始终公开可访问,即使通过签名 URL 使图像变为私有。