# Cloudflare API
> Replicate AI models and Cloudflare Browser Rendering via x402/MPP micropayments. All endpoints POST.

## Base URL
https://cloudflare-api.dev

## Auth
x402/MPP payment (USDC on Base, Solana, or Tempo). Use check_endpoint_schema on any endpoint to get its request schema before calling.

---

## Replicate — AI Models (official models only)

### Discovery ($0.01)
/api/replicate/models/search — Search models
Example: POST /api/replicate/models/search { "query": "flux image generation" }

/api/replicate/models/get — Get model details and input schema
Example: POST /api/replicate/models/get { "owner": "black-forest-labs", "name": "flux-schnell" }

/api/replicate/models/versions — List versions
/api/replicate/collections/list — List curated collections
/api/replicate/collections/get — Get collection by slug

### Run Models (tiered pricing)
/api/replicate/predictions/create-image — Image models ($0.10)
Example: POST /api/replicate/predictions/create-image { "model": "black-forest-labs/flux-schnell", "input": { "prompt": "a cat wearing a top hat" } }

/api/replicate/predictions/create-video — Video/audio models ($1.00)
/api/replicate/predictions/create-text — Language models ($0.05)
/api/replicate/predictions/get — Poll prediction status ($0.01)
/api/replicate/predictions/cancel — Cancel prediction ($0.01)

Pick endpoint by checking default_example.metrics: image_count → image, token counts → text, otherwise → video.

---

## Browser Rendering — Cloudflare headless browser

/api/browser/screenshot — Capture screenshot of any URL ($0.05)
Example: POST /api/browser/screenshot { "url": "https://example.com", "screenshotOptions": { "fullPage": true } }

/api/browser/pdf — Render URL as PDF ($0.05)
Example: POST /api/browser/pdf { "url": "https://example.com" }

/api/browser/markdown — Extract clean Markdown ($0.02)
Example: POST /api/browser/markdown { "url": "https://example.com" }

/api/browser/json — AI-powered structured data extraction ($0.05)
Example: POST /api/browser/json { "url": "https://example.com", "prompt": "Extract all product names and prices" }

/api/browser/scrape — Scrape elements by CSS selector ($0.02)
Example: POST /api/browser/scrape { "url": "https://example.com", "elements": [{ "selector": "h1" }, { "selector": "a" }] }

/api/browser/content — Fetch fully rendered HTML ($0.02)
Example: POST /api/browser/content { "url": "https://example.com" }

/api/browser/links — Extract all links from a page ($0.02)
Example: POST /api/browser/links { "url": "https://example.com", "visibleLinksOnly": true }

All browser endpoints support: cookies, authenticate, userAgent, waitForSelector, gotoOptions.

/api/browser/crawl — Start an async crawl job ($0.10)
Example: POST /api/browser/crawl { "url": "https://example.com/docs/", "limit": 10, "depth": 2, "formats": ["markdown"] }
Returns { "token": "<jwt>" } — use the token to poll for results.

GET /api/browser/crawl/poll?token=<jwt> — Poll crawl results (free, SIWX auth)
Returns crawled pages with markdown/html/json content. Only the wallet that started the crawl can poll.

---

## Images — Cloudflare Images upload + on-the-fly transforms

/api/images/upload — Upload an image by URL ($0.01)
Example: POST /api/images/upload { "url": "https://example.com/photo.jpg" }
Returns { "id": "abc123", "variants": ["https://imagedelivery.net/.../public"], ... }

/api/images/transform — Generate a transformed delivery URL ($0.01)
Example: POST /api/images/transform { "image_id": "abc123", "width": 800, "format": "webp", "quality": 80 }
Returns { "url": "https://imagedelivery.net/.../w=800,format=webp,quality=80", ... }

Supports: width, height, fit (scale-down/contain/cover/crop/pad), quality, format (webp/avif/jpeg/png), gravity (auto/face), rotate, blur, sharpen, brightness, contrast, dpr, metadata.

Workflow: upload once, then generate as many transform URLs as needed. Transforms are cached on CF's edge.