Images 说明文档

# Cloudflare Images 技能参考 **Cloudflare Images** 是一套端到端的图像管理解决方案，通过 Cloudflare 全球网络提供大规模的存储、转换、优化和交付服务。 ## 快速决策树 **需要：** - **在 Worker 中转换？** → [api.md](api.md#workers-binding-api-2026-primary-method) (Workers 绑定 API) - **从 Worker 上传？** → [api.md](api.md#upload-from-worker) (REST API) - **从客户端上传？** → [patterns.md](patterns.md#upload-from-client-direct-creator-upload) (直接创建者上传) - **设置变体？** → [configuration.md](configuration.md#variants-configuration) - **提供响应式图像？** → [patterns.md](patterns.md#responsive-images) - **添加水印？** → [patterns.md](patterns.md#watermarking) - **修复错误？** → [gotchas.md](gotchas.md#common-errors) ## 阅读顺序 **用于构建图像上传/转换功能：** 1. [configuration.md](configuration.md) - 设置 Workers 绑定 2. [api.md](api.md#workers-binding-api-2026-primary-method) - 学习转换 API 3. [patterns.md](patterns.md#upload-from-client-direct-creator-upload) - 直接上传模式 4. [gotchas.md](gotchas.md) - 检查限制和错误 **用于基于 URL 的转换：** 1. [configuration.md](configuration.md#variants-configuration) - 创建变体 2. [api.md](api.md#url-transform-api) - URL 语法 3. [patterns.md](patterns.md#responsive-images) - 响应式模式 **用于故障排除：** 1. [gotchas.md](gotchas.md#common-errors) - 错误消息 2. [gotchas.md](gotchas.md#limits) - 大小/格式限制 ## 核心方法 | 方法 | 用例 | 位置 | |--------|----------|----------| | `env.IMAGES.input().transform()` | 在 Worker 中转换 | [api.md:11](api.md) | | REST API `/images/v1` | 上传图像 | [api.md:57](api.md) | | 直接创建者上传 | 客户端上传 | [api.md:127](api.md) | | URL 转换 | 静态图像交付 | [api.md:112](api.md) | ## 本参考内容 - **[api.md](api.md)** - 完整 API：Workers 绑定、REST 端点、URL 转换 - **[configuration.md](configuration.md)** - 设置：wrangler.toml、变体、身份验证、签名 URL - **[patterns.md](patterns.md)** - 模式：响应式图像、水印、格式协商、缓存 - **[gotchas.md](gotchas.md)** - 故障排除：限制、错误、最佳实践 ## 关键特性 - **自动优化** - AVIF/WebP 格式协商 - **即时转换** - 通过 URL 或 API 进行调整大小、裁剪、模糊、锐化 - **Workers 绑定** -