更新日志

Images 绑定（binding）现在按唯一转换计费，这与已用于基于 URL 转换的计费模型一致。在同一个日历月内对相同源图像和参数组合的重复请求仅计算一次。

在此之前，无论图像或参数是否唯一，对绑定的每次调用都被计为一次单独的转换。有了这项改进，您可以在热点路径上调用绑定，而无需为每个单独的请求付费。

对 .info() 的调用不再计费。

欲了解更多信息，请参阅 Images 定价和 Images 绑定文档。

这些更新为使用 Images 进行优化和操作引入了新功能：

• 全新 composite 选项：控制叠加层如何与底图混合。
• 百分比宽度：将叠加层的尺寸设置为底图尺寸的分数比例。
• 全新 fit 模式：使用 aspect-crop 始终保留目标宽高比，或使用 scale-up 始终放大图像。
• 全新 upscale 参数：应用 AI 放大（upscaling），在放大图像时产生更清晰、更细致的结果。

使用 Images 绑定（binding）可以直接从您的 Worker 上传、列出、检索、更新和删除存储在 Images 中的图像，而无需管理 API 令牌（tokens）或发送 HTTP 请求。

env.IMAGES.hosted 命名空间支持以下存储和管理操作：

• .upload(image, options) — 向您的账户上传一个新图像。
• .list(options) — 通过分页列出图像。
• .image(imageId).details() — 获取图像元数据。
• .image(imageId).bytes() — 流式传输原始图像字节。
• .image(imageId).update(options) — 更新元数据或访问控制。
• .image(imageId).delete() — 删除图像。

例如，您可以从请求主体中上传图像并返回其元数据：

const image = await env.IMAGES.hosted.upload(request.body, {
	filename: "upload.jpg",
	metadata: { source: "worker" },
});

return Response.json(image);

或者检索并提供托管图像的原始字节：

const bytes = await env.IMAGES.hosted.image("IMAGE_ID").bytes();
return new Response(bytes);

欲了解更多信息，请参阅 Images 绑定。

流（Flows）是自动规则，它将条件（例如文件扩展名、URL 路径或查询参数）与参数进行匹配。您可以设置一个流，以自动将图像优化应用到您区域上的匹配请求，而无需编写代码或更改 URL。

转换流有两种模式：

• 提供商流（Provider flows） — 从其他图像优化服务进行迁移。您现有的 URL 将继续工作，同时 Cloudflare 会将特定提供商的参数重写为 Cloudflare 对应的参数。目前，Cloudflare 支持针对 Fastly Image Optimizer 的提供商流。
• 自定义流（Custom flows） — 为自动格式转换、具有 width=auto 的响应式大小调整或基于目录的优化等使用场景定义您自己的条件和操作。

若要开始使用，请转到 Cloudflare 仪表板 ↗中的 Images > Transformations（转换） > Automation（自动化）。

详细了解转换流。