1# API Reference
2 
3## Workers Binding API
4 
5```toml
6# wrangler.toml
7[images]
8binding = "IMAGES"
9```
10 
11### Transform Images
12 
13```typescript
14const imageResponse = await env.IMAGES
15  .input(fileBuffer)
16  .transform({ width: 800, height: 600, fit: "cover", quality: 85, format: "avif" })
17  .output();
18return imageResponse.response();
19```
20 
21### Transform Options
22 
23```typescript
24interface TransformOptions {
25  width?: number;        height?: number;
26  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
27  quality?: number;      // 1-100
28  format?: "avif" | "webp" | "jpeg" | "png";
29  dpr?: number;          // 1-3
30  gravity?: "auto" | "left" | "right" | "top" | "bottom" | "face" | string;
31  sharpen?: number;      // 0-10
32  blur?: number;         // 1-250
33  rotate?: 90 | 180 | 270;
34  background?: string;   // CSS color for pad
35  metadata?: "none" | "copyright" | "keep";
36  brightness?: number;   contrast?: number;   gamma?: number;  // 0-2
37}
38```
39 
40### Draw/Watermark
41 
42```typescript
43await env.IMAGES.input(baseImage)
44  .draw(env.IMAGES.input(watermark).transform({ width: 100 }), { top: 10, left: 10, opacity: 0.8 })
45  .output();
46```
47 
48## REST API
49 
50### Upload Image
51 
52```bash
53curl -X POST https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1 \
54  -H "Authorization: Bearer {token}" -F [email protected] -F metadata='{"key":"value"}'
55```
56 
57### Other Operations
58 
59```bash
60GET  /accounts/{account_id}/images/v1/{image_id}      # Get details
61DELETE /accounts/{account_id}/images/v1/{image_id}   # Delete
62GET  /accounts/{account_id}/images/v1?page=1         # List
63```
64 
65## URL Transform API
66 
67```
68https://imagedelivery.net/{hash}/{id}/width=800,height=600,fit=cover,format=avif
69```
70 
71**Params:** `w=`, `h=`, `fit=`, `q=`, `f=`, `dpr=`, `gravity=`, `sharpen=`, `blur=`, `rotate=`, `background=`, `metadata=`
72 
73## Direct Creator Upload
74 
75```typescript
76// 1. Get upload URL (backend)
77const { result } = await fetch(
78  `https://api.cloudflare.com/client/v4/accounts/${accountId}/images/v2/direct_upload`,
79  { method: 'POST', headers: { 'Authorization': `Bearer ${token}` },
80    body: JSON.stringify({ requireSignedURLs: false }) }
81).then(r => r.json());
82 
83// 2. Client uploads to result.uploadURL
84const formData = new FormData();
85formData.append('file', file);
86await fetch(result.uploadURL, { method: 'POST', body: formData });
87```
88 
89## Error Codes
90 
91| Code | Message | Solution |
92|------|---------|----------|
93| 5400 | Invalid format | Use JPEG, PNG, GIF, WebP |
94| 5401 | Too large | Max 100MB |
95| 5403 | Invalid transform | Check params |
96| 9413 | Rate limit | Implement backoff |
97