SuperAPI AI 工具集

cloudflare-images

设计与创作

查看项目

更新于 10-15 22:39

技能介绍

用途:该技能面向 Cloudflare Images,覆盖 Images API(上传、存储、分发图片)与 Image Transformations(优化任意可公开访问的图片),依赖已启用 Images 的 Cloudflare 账户,API 版本为 v2。

主要能力:Images API 支持文件上传、通过 URL 上传、Direct Creator Upload(生成一次性上传 URL,避免暴露 API 密钥);提供默认域名 imagedelivery.net、自定义域名与签名 URL。Image Transformations 支持通过 URL 或 Workers 对任意图片进行缩放、质量、格式、裁剪、特效与旋转等处理,并自动转换为 WebP/AVIF。变体分为命名变体(最多 100 个)与灵活变体(动态参数,不能与签名 URL 同用)。签名 URL 使用 HMAC-SHA256 生成限时访问链接。

使用方式:先在控制台启用 Images 并获取 Account ID 与 API Token。上传示例:curl --request POST --url https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/images/v1 --header 'Authorization: Bearer <API_TOKEN>' --header 'Content-Type: multipart/form-data' --form 'file=@./image.jpg'。分发使用 https://imagedelivery.net/<ACCOUNT_HASH>/<IMAGE_ID>/public。URL 转换格式为 /cdn-cgi/image/<OPTIONS>/<SOURCE-IMAGE>,需先在对应 zone 启用 Transformations。Workers 中通过 fetch 的 cf.image 参数转换。

适用场景:图片托管与全球 CDN 分发、响应式图片、私有图片限时访问、用户直传、外部图片优化。

限制:文件上传必须用 multipart/form-data;Direct Creator Upload 只能由后端调用 /direct_upload;灵活变体不能用于 requireSignedURLs=true;转换仅支持 HTTPS;不要缩放 SVG;单图不超过 100 百万像素;Workers 中避免重复转换同一图片;使用 /cdn-cgi/image/ 前须在 zone 启用转换。资料未提供具体收费与价格信息。