cloudflare-images - 使用 Cloudflare Images API 存储和转换图像
使用 Cloudflare Images API 和图像转换功能上传、存储和转换图像
标签
更新于: 2026-02-09该技能可以做什么
- 通过 multipart 表单上传图像
- 生成直接创建者上传 URL
- 创建图像变体
- 生成签名 URL
- 通过 URL 参数调整图像大小
- 通过 Workers 转换图像
- 使用 AI 人脸检测裁剪图像
- 自动优化图像格式
- 剥离图像元数据
- 调试转换错误
- 处理 CORS 问题
- 管理 multipart 上传
- 强制执行 AVIF 大小限制
- 解决缓存问题
- 解释错误代码 9401-9413
输入
- 启用了 Images 的 Cloudflare 账户
- 具有 Images:Edit 权限的 API token
- 用于上传的图像文件
- 用于转换的图像 URL
- 上传配置选项
- 转换参数
- HMAC-SHA256 签名密钥
- 直接上传请求数据
输出
- 存储在 Cloudflare Images 中的图像
- 具有预定义设置的图像变体
- 直接创建者上传 URL
- 私有图像的签名 URL
- 转换后的图像响应
- 错误代码和诊断头信息
- 上传成功/失败状态
- 图像元数据修改
要求
- 启用了 Images 功能的 Cloudflare 账户
- 具有 Images:Edit 权限的 API token
- 用于图像转换的 HTTPS URL
- 用于文件上传的 multipart/form-data
- 用于直接上传 API 调用的后端服务器
- 用于编程转换的 Workers 环境
- 有效的图像格式（JPEG、PNG、GIF、WebP、AVIF）