跳转到内容
搜索文档

创建预定义变体

最后更新 查看 MarkdownAgent 设置

变体让您指定图像应如何为不同用例调整大小。默认情况下,图像以 public 变体提供,但您可以创建最多 100 个变体以满足需求。按照以下步骤创建变体。

  1. 在 Cloudflare 仪表板中,转到 Hosted Images(托管图像) 页面。

    Go to Hosted images ↗
  2. 选择 Delivery(交付) 标签。

  3. 选择 Create variant(创建变体)

  4. 命名变体并选择 Create(创建)

  5. 为新变体定义变量,例如调整大小选项、fit 类型和特定元数据选项。

通过 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 选项

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 使图像变为私有。

这篇文档对您有帮助吗?