# Tanod Images

> Image toolkit: resize, convert, compress, crop, metadata, hashes, favicons, OCR, QR codes, barcodes. A focused part of Tanod (https://tanod.dev/llms.txt covers every family), over HTTP and MCP.
>
> Pay per call in USDC on Base or Polygon or Solana with x402, or on Tempo with MPP; no account or API key. Free tier: a small daily per-IP
> pool per family; over HTTP add the header `X-Tanod-Free: 1` to an unpaid call (without it every unpaid call gets the 402); over MCP
> the free tier is automatic.
> Every result is automated and heuristic, not an audit: findings can be false positives, and a clean result is not proof that code or a package is free of risk.
> Tanod is operated by an autonomous AI agent on behalf of its owner. Scans run automatically; no person reviews individual results.

## API

- [OpenAPI spec](https://images.tanod.dev/openapi.json): machine-readable description of this family's 18 routes.
- [x402 resources](https://images.tanod.dev/.well-known/x402)
- MCP: `https://tanod.dev/mcp/images` (server `tanod-images`)

## Routes

- `POST https://images.tanod.dev/v1/ocr` (ocr_image): Image to text: OCR an image URL and extract text from the image (sitepeek) Use when an agent needs image to text: extract text from an image such as a scan, screenshot or photo.
- `POST https://images.tanod.dev/v1/qr` (generate_qr_code): Generate a QR code: make or create a QR code image (SVG or PNG) for text or a URL (utilpeek) Use when an agent must hand a person text or a URL as a scannable QR code image. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/barcode` (generate_barcode): Generate a barcode image: Code 128, Code 39, EAN, UPC-A, ISBN-13 (utilpeek) Use when an agent must produce a Code 128, Code 39, EAN, UPC-A or ISBN barcode image. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/color/convert` (convert_color_check_wcag_contrast): Convert a color between hex, RGB, HSL and OKLCH and check WCAG contrast (utilpeek) Use when an agent must convert a color between hex, RGB, HSL, CMYK and OKLCH, or check WCAG contrast.
- `POST https://images.tanod.dev/v1/image/resize` (resize_image): Resize an image: scale an image or change its size (fit inside, contain, cover or fill) (imagepeek) Use when an image must be scaled to given dimensions, keeping or ignoring its aspect ratio. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/convert` (convert_image_format): Convert an image format: PNG to JPG, convert to WebP, GIF, TIFF, BMP, ICO or AVIF (imagepeek) Use when an image must be changed between formats such as PNG, JPEG, WebP, GIF, TIFF, BMP, ICO or AVIF.
- `POST https://images.tanod.dev/v1/image/compress` (compress_image): Compress an image: reduce image size and optimize it, optionally to a byte budget (imagepeek) Use when an image must be shrunk to a quality level or a maximum file size. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/crop` (crop_image): Crop an image to a box or an aspect ratio (imagepeek) Use when an image must be cut to a box or to a given aspect ratio. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/rotate` (rotate_flip_image): Rotate (any angle) or flip an image (imagepeek) Use when an image must be turned or flipped, for example to fix its orientation. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/thumbnail` (make_image_thumbnail): Make an image thumbnail: create or generate 1-8 thumbnails of an image in one call (imagepeek) Use when several thumbnail sizes (1-8) of one image are needed at once. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/metadata` (read_image_exif): Read image EXIF: get image metadata incl. GPS data, XMP, IPTC and ICC (imagepeek) Use when an agent needs an image's EXIF, GPS, XMP, IPTC or ICC metadata.
- `POST https://images.tanod.dev/v1/image/strip-metadata` (strip_image_exif_metadata): Strip an image's EXIF, GPS, XMP, IPTC and comment metadata (imagepeek) Use when an image must lose its EXIF, GPS and other embedded metadata before it is shared. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/watermark` (watermark_image): Add a text watermark to an image (one mark or tiled) (imagepeek) Use when an image must be stamped with a text mark, single or tiled. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/colors` (extract_image_colors): Extract image colors: the color palette and dominant colors of an image (imagepeek) Use when an agent needs the dominant colors or palette of an image.
- `POST https://images.tanod.dev/v1/image/hash` (perceptual_image_hash): Compute perceptual hashes of an image, optionally compared (imagepeek) Use when images must be compared for near-duplicates with perceptual hashes.
- `POST https://images.tanod.dev/v1/image/favicon` (generate_favicon_set): Generate a favicon set (ICO, PNGs, apple-touch-icon) from an image (imagepeek) Use when one source image must become a favicon set with ICO, PNG icons and an HTML snippet. Add output=url for a 24 h link.
- `POST https://images.tanod.dev/v1/image/blurhash` (generate_image_blurhash): Generate a BlurHash placeholder string for an image (imagepeek) Use when an image needs a compact BlurHash string to show as a placeholder while it loads.
- `POST https://images.tanod.dev/v1/image/qr-read` (read_qr_code): Read a QR code: scan and decode every QR code and barcode in an image (imagepeek) Use when an image holds QR codes or barcodes whose decoded text, positions or payment fields are needed.