Cloudflare Images

Cloudflare Images provides image upload, storage, and global delivery via Cloudflare's edge network. Key agent capabilities: programmatic image upload (direct or via URL), variant creation (resize/crop/fit configs), image listing, and deletion. Flat pricing includes unlimited bandwidth — no egress surprises. Delivery via image URLs with variant suffix (e.g. /public or /thumbnail). Automatic format conversion to WebP/AVIF based on browser support. Distinct from Cloudflare R2 (object storage) — Images is optimized for visual media with transformation primitives. Good fit for agent pipelines generating or managing visual content. Confidence is docs-derived.

Bearer token auth via Cloudflare API token (scoped to Images permissions: Read, Edit) or API key + email combo. Token scoping for Images is independent of other Cloudflare services — principle of least privilege supported. Signed URL generation for private images requires an account-level signing key. Standard Cloudflare IAM with role-based token policies.

developers.cloudflare.com/images/ provides complete documentation: upload flows, variant configuration, delivery URL structure, signed URLs, and Workers integration. API reference is part of the broader Cloudflare API docs with full OpenAPI spec available. Getting started requires a Cloudflare account with Images enabled. Documentation quality matches Cloudflare's consistently high standard across their products.

REST API at api.cloudflare.com/client/v4/accounts/{account_id}/images/v1. Upload via multipart/form-data (file) or URL (url param). Variants defined at the account level: create once, apply to all images via URL suffix. List images (paginated), get metadata, delete. Response envelope: {result: {...}, success: bool, errors: [], messages: []} consistent with Cloudflare's API pattern. Variants can be private (signed URLs) or public.

Cloudflare's standard error format: {success: false, errors: [{code: N, message: '...'}]} with HTTP status codes. Common errors: 400 (invalid request), 401 (invalid token), 9422 (image processing failed). Rate limits per account. Cloudflare Images is backed by Cloudflare's global infrastructure; uptime tied to Cloudflare's edge SLA. Image delivery failures fall back gracefully. Transformation errors return 400 with code indicating the unsupported operation.