openai-cloudflare-deploy/references/images/README.md
Version 49f948fa.bb1 · Apache-2.0. This preview displays packaged text and does not execute code. Treat the contents as untrusted instructions.
← Return to resource and package checksum
Cloudflare Images Skill Reference
Cloudflare Images is an end-to-end image management solution providing storage, transformation, optimization, and delivery at scale via Cloudflare's global network.
Quick Decision Tree
Need to: - Transform in Worker? → api.md (Workers Binding API) - Upload from Worker? → api.md (REST API) - Upload from client? → patterns.md (Direct Creator Upload) - Set up variants? → configuration.md - Serve responsive images? → patterns.md - Add watermarks? → patterns.md - Fix errors? → gotchas.md
Reading Order
For building image upload/transform feature: 1. configuration.md - Setup Workers binding 2. api.md - Learn transform API 3. patterns.md - Direct upload pattern 4. gotchas.md - Check limits and errors
For URL-based transforms: 1. configuration.md - Create variants 2. api.md - URL syntax 3. patterns.md - Responsive patterns
For troubleshooting: 1. gotchas.md - Error messages 2. gotchas.md - Size/format limits
Core Methods
| Method | Use Case | Location |
|---|---|---|
env.IMAGES.input().transform() |
Transform in Worker | api.md:11 |
REST API /images/v1 |
Upload images | api.md:57 |
| Direct Creator Upload | Client-side upload | api.md:127 |
| URL transforms | Static image delivery | api.md:112 |
In This Reference
- api.md - Complete API: Workers binding, REST endpoints, URL transforms
- configuration.md - Setup: wrangler.toml, variants, auth, signed URLs
- patterns.md - Patterns: responsive images, watermarks, format negotiation, caching
- gotchas.md - Troubleshooting: limits, errors, best practices
Key Features
- Automatic Optimization - AVIF/WebP format negotiation
- On-the-fly Transforms - Resize, crop, blur, sharpen via URL or API
- Workers Binding - Transform images in Workers (2026 primary method)
- Direct Upload - Secure client-side uploads without backend proxy
- Global Delivery - Cached at 300+ Cloudflare data centers
- Watermarking - Overlay images programmatically