使用 Images 绑定管理托管的图像
使用 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 绑定。