SuperAPI AI 工具集

cloudflare-images

设计与创作

查看项目

更新于 10-15 23:31

技能介绍

用途:该技能覆盖 Cloudflare Images 的两大能力——Images API(上传、存储并生成命名变体)与 Image Transformations(通过 URL 或 Workers 对任意图片做缩放、裁剪、格式转换),适合在网站或应用中统一管理图片分发与优化。

主要能力:上传方式包括直接文件上传、从 URL 抓取、以及面向用户的前端直传(Direct Creator Upload,后端生成一次性 uploadURL,避免暴露 API 密钥)。变换支持 width、height、fit、quality、format=auto、gravity(含 AI 人脸裁剪 gravity=face 与 zoom)、blur、sharpen、brightness 等参数。变体分命名变体(最多 100 个,可配合签名 URL)与 Flexible Variants(动态参数,但不能用于 requireSignedURLs=true)。私有图片用 HMAC-SHA256 签名 URL。

使用方式:先在控制台启用 Images 并取得账户 ID 与 API token(Images: Edit 权限)。上传示例:curl -X POST https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/images/v1 -H 'Authorization: Bearer <API_TOKEN>' -H 'Content-Type: multipart/form-data' -F 'file=@./image.jpg'。分发地址为 https://imagedelivery.net/<ACCOUNT_HASH>/<IMAGE_ID>/public。变换需先在 zone 上启用,再使用 /cdn-cgi/image/width=800,quality=85/uploads/photo.jpg;Workers 中改用 cf.image 选项,不在 Worker 里请求 /cdn-cgi/image/。

限制与注意事项:文件字段必须命名为 file;直传接口只能由后端调用;变换仅支持 HTTPS;SVG 不参与缩放;单图不超过 100 百万像素;WebP 与 PNG 输出始终丢弃元数据,仅 JPEG 可通过 metadata 保 EXIF;format=avif 存在分辨率上限争议;已知坑包括 9401/9402/9403/9406/9412/9419 等错误、直传 CORS、超时 5408、灵活变体不支持签名 URL,以及 PNG 默认不缓存。Mirage 已于 2025-09-15 弃用,应迁移至 Cloudflare Images。费用、价格与具体平台配额资料中暂未提供。