# x402 Image Tools – Smart Thumbnail Generator

> x402 Image Tools – Smart Thumbnail Generator is a paid API for AI agents from image.kagurazaka.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Generates a square thumbnail of an image by smart-cropping around the most interesting region, returned as WebP (or other formats) at a configurable pixel size.

## Facts

- Endpoint: POST https://image.kagurazaka.dev/v1/thumbnail?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-image-tools-smart-thumbnail-generator-10f8df3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GXsDCENfuXAwmuLyziwlO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-image-tools-smart-thumbnail-generator-10f8df3a -d '<json body>'
```

Example prompt: Can you generate a 512-pixel square WebP thumbnail of this image — https://example.com/photo.jpg — smart-cropped around the most interesting part?

## When to prefer this

Choose this endpoint when you need a square, content-aware cropped thumbnail rather than a naive center or edge crop. It is ideal for product images, profile pictures, and content previews where the subject may not be centered. Prefer it over generic resize endpoints when smart-cropping around the most visually salient region matters, and when WebP or AVIF output is desired for web performance. The $0.002 per-call pricing via x402 makes it suitable for on-demand, per-image pipelines.

## Known failure modes

- Image URL is unreachable or returns a non-200 response — returns an error indicating the source could not be fetched
- Image exceeds 20 MB or 40 megapixel limit — returns a payload-too-large or dimension error
- Unsupported image format provided — returns a format validation error
- Requested size outside 16–1024 range — returns a validation error
- Payment not provided or insufficient — returns HTTP 402 requiring USDC payment
- Temporary CDN or processing backend failure — returns a 5xx error

## How this service works

A square thumbnail of an image, smart-cropped around its most interesting region, as WebP by default.

## Output

Returns a JSON object containing a CDN URL to the generated square thumbnail (valid for 3600 seconds), the thumbnail's dimensions (width and height in pixels), format, file size in bytes, and the original image's file size. Optionally includes the image as a base64 data URL if it is under 1 MB and the inline flag was set.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "https URL of a JPEG, PNG, WebP, AVIF, GIF, TIFF or SVG image (up to 20 MB, 40 megapixels)"
  },
  "size": {
   "type": "integer",
   "description": "side in pixels (16-1024, default 256)"
  },
  "format": {
   "enum": [
    "webp",
    "avif",
    "png",
    "jpeg",
    "gif",
    "tiff"
   ],
   "type": "string",
   "description": "output format (default: the input's)"
  },
  "inline": {
   "type": "boolean",
   "description": "also return the image as a data URL when it is at most 1 MB"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://dn8i8p8knpn68.cloudfront.net/results/images/3f1c2b9e.webp?Expires=...",
  "bytes": 48213,
  "width": 256,
  "format": "webp",
  "height": 256,
  "expires_in": 3600,
  "input_bytes": 912345
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-image-tools-smart-thumbnail-generator-10f8df3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from image.kagurazaka.dev](https://www.zero.xyz/host/image.kagurazaka.dev/llms.txt)