# Cloudflare Images

Store, transform, optimize, and deliver images at scale

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/images/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Images](https://cloudflaredoc.ubitools.com/images/index.md): Images 是一个用于构建可扩展、可靠图像管道的平台，旨在帮助开发者更快地部署富媒体应用。

## 演示和架构

- [演示和架构](https://cloudflaredoc.ubitools.com/images/demos/index.md): 探索 Cloudflare Images 的演示应用和参考架构。

## 定价

- [定价](https://cloudflaredoc.ubitools.com/images/pricing/index.md): Cloudflare Images 在 Free 和 Paid 计划下的转换、存储和交付定价。

## Cloudflare Polish

- [Cloudflare Polish](https://cloudflaredoc.ubitools.com/images/polish/index.md): Cloudflare Polish 通过剥离元数据并应用有损或无损压缩来自动优化图像。
- [启用 Polish](https://cloudflaredoc.ubitools.com/images/polish/activate-polish/index.md): 在仪表板中启用 Cloudflare Polish，以有损或无损压缩自动优化图像。
- [Cf-Polished 状态](https://cloudflaredoc.ubitools.com/images/polish/cf-polished-statuses/index.md): 了解 Cloudflare Images 中的 Cf-Polished 状态。了解如何处理缺失标头、优化图像格式以及排查常见问题。
- [Polish 压缩](https://cloudflaredoc.ubitools.com/images/polish/compression/index.md): 了解 Cloudflare 的 Polish 压缩选项，包括 Lossless、Lossy 和 WebP，在有效管理元数据的同时优化图像文件大小。
- [可能跳过 WebP](https://cloudflaredoc.ubitools.com/images/polish/no-webp/index.md): 当 WebP 转换会增加文件大小或降低图像质量时，Cloudflare Polish 会跳过 WebP 转换。

## Images API 参考

- [Images API 参考](https://cloudflaredoc.ubitools.com/api/resources/images/subresources/v1/methods/list/index.md): 管理 Cloudflare Images 的完整 API 参考，包括上传、列出、更新和删除操作。

## 示例

- [示例](https://cloudflaredoc.ubitools.com/images/examples/index.md): Cloudflare Images 常见用例的代码示例，包括转码和添加水印。
- [转码图像](https://cloudflaredoc.ubitools.com/images/examples/transcode-from-workers-ai/index.md): 在上传到 R2 之前从 Workers AI 转码图像
- [水印](https://cloudflaredoc.ubitools.com/images/examples/watermark-from-kv/index.md): 在来自 R2 的图像上从 KV 绘制水印

## get-started

- [简介](https://cloudflaredoc.ubitools.com/images/get-started/introduction/index.md): Cloudflare Images 提供用于大规模优化、存储和交付图像的平台。
- [核心概念](https://cloudflaredoc.ubitools.com/images/get-started/key-concepts/index.md): Cloudflare Images 核心术语的定义，包括转换、变体、托管图像和源站。
- [限制和格式](https://cloudflaredoc.ubitools.com/images/get-started/limits/index.md): Cloudflare Images 支持的文件格式、大小限制和尺寸约束。

## optimization

- [使用 Workers 优化](https://cloudflaredoc.ubitools.com/images/optimization/binding/index.md): 使用 Images 绑定在 Worker 中直接从任意源优化、调整大小和处理图像。
- [绘制叠加和水印](https://cloudflaredoc.ubitools.com/images/optimization/draw-overlays/index.md): 使用 Workers 在其他图像上添加水印、徽标和叠加图像。
- [功能](https://cloudflaredoc.ubitools.com/images/optimization/features/index.md): Cloudflare Images 可用的优化参数，用于调整大小、裁剪、格式转换和视觉效果。
- [应用模糊](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/blur-variants/index.md): 使用仪表板或灵活变体 API 为 Cloudflare Images 变体添加模糊效果。
- [Browser TTL](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/browser-ttl/index.md): 在账户或变体级别配置 Cloudflare Images 的 cache-control 设置。
- [创建预定义变体](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/create-variants/index.md): 在 Cloudflare Images 中定义命名变体，控制托管图像的调整大小和提供方式。
- [删除变体](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/delete-variants/index.md): 使用仪表板或 API 从 Cloudflare Images 中删除图像变体。
- [启用灵活变体](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/enable-flexible-variants/index.md): 在 Cloudflare Images 中启用灵活变体，允许超出预定义变体选项的动态调整大小。
- [从自定义域名提供图像](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/serve-from-custom-domains/index.md): 使用 cdn-cgi 图像交付路径通过您自己的自定义域名交付 Cloudflare Images。
- [提供私有图像](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/serve-private-images/index.md): 通过生成带过期时间的签名 URL 令牌来限制对 Cloudflare Images 的访问。
- [提供已上传的图像](https://cloudflaredoc.ubitools.com/images/optimization/hosted-images/serve-uploaded-images/index.md): 构建交付 URL，使用账户哈希、图像 ID 和变体名称提供上传到 Cloudflare Images 的图像。
- [提供响应式图像](https://cloudflaredoc.ubitools.com/images/optimization/make-responsive-images/index.md): 自动调整图像大小以在每个设备上实现最佳显示。
- [控制源站访问](https://cloudflaredoc.ubitools.com/images/optimization/transformations/control-origin-access/index.md): 使用 Cloudflare Workers 和图像转换隐藏原始图像源并限制访问。
- [绘制叠加和水印](https://cloudflaredoc.ubitools.com/images/optimization/draw-overlays/index.md): 使用 Cloudflare Workers 在转换后的图像上添加水印、徽标和叠加图像。
- [创建转换流程](https://cloudflaredoc.ubitools.com/images/optimization/transformations/flows/index.md)
- [与框架集成](https://cloudflaredoc.ubitools.com/images/optimization/transformations/integrate-with-frameworks/index.md): 将 Cloudflare Images 转换与 Next.js 和 Nuxt 图像组件一起使用。
- [概览](https://cloudflaredoc.ubitools.com/images/optimization/transformations/overview/index.md): Cloudflare Images 转换在边缘优化和缓存来自任意源站的远程图像。
- [保留 Content Credentials](https://cloudflaredoc.ubitools.com/images/optimization/transformations/preserve-content-credentials/index.md): 使用 Cloudflare Images 转换远程图像时保留 C2PA 元数据和来源数据。
- [设置重写规则](https://cloudflaredoc.ubitools.com/images/optimization/transformations/rewrite-rules/index.md): 使用 Transform Rules 为 Cloudflare Images 转换重写 URL，并从自定义路径提供图像。
- [定义源站源](https://cloudflaredoc.ubitools.com/images/optimization/transformations/sources/index.md): 管理 Cloudflare Images 可用作图像转换源站的源站。
- [通过 fetch 转换](https://cloudflaredoc.ubitools.com/images/optimization/transformations/transform-via-workers/index.md): 在 Worker 中对 fetch() 子请求使用 cf.image 选项以程序化调整大小、格式化和优化远程图像。

## platform

- [更新日志](https://cloudflaredoc.ubitools.com/images/platform/changelog/index.md): Cloudflare Images 的最新变更和更新。

## reference

- [安全](https://cloudflaredoc.ubitools.com/images/reference/security/index.md): 使用 WAF、Bot Management 和 Rate Limiting 保护 Cloudflare Images 优化请求免受滥用。
- [故障排除](https://cloudflaredoc.ubitools.com/images/reference/troubleshooting/index.md): 诊断和解决常见的 Cloudflare Images 调整大小错误，包括错误代码和源站配置问题。

## storage

- [使用 Workers 管理托管图像](https://cloudflaredoc.ubitools.com/images/storage/binding/index.md): 使用 Images 绑定从 Worker 上传、列出、检索、更新和删除托管图像。
- [删除图像](https://cloudflaredoc.ubitools.com/images/storage/manage-images/delete-images/index.md): 使用仪表板或 API 从 Cloudflare Images 存储中删除图像。
- [编辑图像](https://cloudflaredoc.ubitools.com/images/storage/manage-images/edit-images/index.md): 修改 Cloudflare Images 中的图像设置，包括签名 URL 要求和变体 URL。
- [导出图像](https://cloudflaredoc.ubitools.com/images/storage/manage-images/export-images/index.md): 通过仪表板或 API 下载存储在 Cloudflare Images 中的图像的原始版本。
- [配置 webhooks](https://cloudflaredoc.ubitools.com/images/storage/upload-images/configure-webhooks/index.md): 设置 webhooks 以在 Cloudflare Images direct creator upload 成功或失败时接收通知。
- [接受用户上传的图像](https://cloudflaredoc.ubitools.com/images/storage/upload-images/direct-creator-upload/index.md): 使用 Cloudflare Images Direct Creator Upload 让用户通过一次性 URL 上传图像，而无需暴露 API 凭证。
- [通过 Batch API 上传](https://cloudflaredoc.ubitools.com/images/storage/upload-images/images-batch/index.md): 使用 Cloudflare Images batch API 进行顺序请求，同时绕过全局 API 速率限制。
- [方法](https://cloudflaredoc.ubitools.com/images/storage/upload-images/methods/index.md): 通过仪表板、API 或使用 Sourcing Kit 从 S3 导入将图像上传到 Cloudflare Images。
- [通过 Sourcing Kit 上传](https://cloudflaredoc.ubitools.com/images/storage/upload-images/sourcing-kit/index.md): 使用 Sourcing Kit 从 Amazon S3 批量导入图像到 Cloudflare Images。
- [凭证](https://cloudflaredoc.ubitools.com/images/storage/upload-images/sourcing-kit/credentials/index.md): 配置 AWS IAM 凭证以授予 Cloudflare Images Sourcing Kit 对 Amazon S3 存储桶的读取访问权限。
- [编辑源](https://cloudflaredoc.ubitools.com/images/storage/upload-images/sourcing-kit/edit/index.md): 在 Cloudflare Images 中重命名、删除或中止 Sourcing Kit 源的导入作业。
- [启用 Sourcing Kit](https://cloudflaredoc.ubitools.com/images/storage/upload-images/sourcing-kit/enable/index.md): 设置 Sourcing Kit 以创建导入作业并开始从 Amazon S3 导入图像到 Cloudflare Images。
- [通过自定义路径上传](https://cloudflaredoc.ubitools.com/images/storage/upload-images/upload-custom-path/index.md): 上传到 Cloudflare Images 时分配自定义 ID 路径，而不是使用自动生成的 UUID。
- [通过 Worker 上传](https://cloudflaredoc.ubitools.com/images/storage/upload-images/upload-file-worker/index.md): 了解如何使用 Workers 将图像上传到 Cloudflare。本指南提供高效上传标准图像和 AI 生成图像的代码示例。
- [通过 URL 上传](https://cloudflaredoc.ubitools.com/images/storage/upload-images/upload-url/index.md): 通过提供源 URL 而非文件将图像上传到 Cloudflare Images。

## tutorials

- [优化移动端浏览](https://cloudflaredoc.ubitools.com/images/tutorials/optimize-mobile-viewing/index.md): 延迟加载是一种简单的方法，可以优化网页上的图像以适配移动设备，实现更快的页面加载速度和更低的成本。
- [在上传到 R2 之前转换用户上传的图像](https://cloudflaredoc.ubitools.com/images/tutorials/optimize-user-uploaded-image/index.md): 设置绑定以将 Images、R2 和 Assets 连接到 Worker