Images

Images is a bounded local raster-transform binding. Input is request-body bytes. Transforms run on the node running ocd. This is not hosted Cloudflare Images.

For example, you can use Images for:

• Resizing and converting request-body images
• Overlay and output jpeg / png / webp / avif
• Inspecting format with info()

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    if (!request.body) return new Response("empty", { status: 400 });
    const out = await env.IMAGES.input(request.body)
      .transform({ width: 200, fit: "scale-down" })
      .output({ format: "image/webp" });
    return out.response();
  },
} satisfies ExportedHandler<{ IMAGES: ImagesBinding }>;

Declare it in cloudflare.config.ts. Images is not a resource id in bindings. Use top-level "images": { "binding": "IMAGES" } only:

import { bindings, defineConfig } from "cf/config";

export default defineConfig({
  worker: {
    name: "img-app",
    entrypoint: "src/index.ts",
    env: {
      IMAGES: bindings.images(),
    },
  },
});

See bindings. Use project-local cf for types and ocd cf deploy for a real target.

Compatibility

Topic	Cloudflare	open-compute
Binding API	Images binding chain	Same chain: input → transform / draw → output → response(), plus info()
Product	Hosted Cloudflare Images	Bounded local raster binding
Input	Hosted image id or URL	ReadableStream bytes
Upload / signing	Available	Not provided
URL transform	Available	Not provided
Video	Available	Not provided
AI upscale	Available	Not provided
Binding	cf images	"images": { "binding": "IMAGES" }

Next: Develop with bindings · Compatibility and limits