# Tanod imagepeek Image Crop

> Tanod imagepeek Image Crop is a paid API for AI agents from tanod.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Crops an image to a specified pixel box or aspect ratio, with configurable gravity, format, and quality.

## Facts

- Endpoint: POST https://tanod.dev/v1/image/crop?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-imagepeek-image-crop-0df12632
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E6F4wb5CpS0yK4Cvwveao

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 tanod-imagepeek-image-crop-0df12632 -d '<json body>'
```

Example prompt: Crop this image (https://example.com/photo.jpg) to a 16:9 aspect ratio, keeping the center in frame, and return it as a JPEG at quality 85.

## When to prefer this

Choose this endpoint when you need a simple, pay-per-call image crop operation without standing up your own image processing infrastructure. It supports both URL-based and base64 image input, aspect-ratio cropping with gravity control, and multiple output formats — making it more flexible than basic crop utilities for agent workflows that need to process images on the fly.

## Known failure modes

- Image URL is not publicly accessible or exceeds 10 MB — returns an error
- Both url and image_base64 are omitted — returns validation error
- Crop box coordinates fall outside image bounds — may return error or clamp
- Unsupported or corrupted image format — returns processing error
- Invalid aspect ratio string format — returns schema validation error
- Network timeout fetching remote image URL

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

Returns the cropped image as binary data in the requested output format (defaulting to the input format). The image is cropped either to the specified pixel box (top/left/width/height) or to the given aspect ratio using the selected gravity direction. EXIF orientation is applied first if auto_orient is enabled.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "top": {
   "anyOf": [
    {
     "type": "integer",
     "maximum": 32768,
     "minimum": 0
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Box mode: top edge in pixels."
  },
  "url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Public http(s) URL of the image (at most 10 MB; private, internal and IP-literal hosts are refused); or use image_base64."
  },
  "left": {
   "anyOf": [
    {
     "type": "integer",
     "maximum": 32768,
     "minimum": 0
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Box mode: left edge in pixels (give left, top, width and height together, or aspect)."
  },
  "width": {
   "anyOf": [
    {
     "type": "integer",
     "maximum": 32768,
     "minimum": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Box mode: crop width in pixels (1-32768)."
  },
  "aspect": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^\\d{1,4}(\\.\\d{1,3})?:\\d{1,4}(\\.\\d{1,3})?$"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Instead of a box, e.g. 16:9, with gravity."
  },
  "format": {
   "anyOf": [
    {
     "enum": [
      "png",
      "jpeg",
      "webp",
      "gif",
      "tiff",
      "bmp",
      "ico",
      "avif"
     ],
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Output format (default: the input's; ICO in, PNG out)."
  },
  "height": {
   "anyOf": [
    {
     "type": "integer",
     "maximum": 32768,
     "minimum": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Box mode: crop height in pixels (1-32768)."
  },
  "output": {
   "enum": [
    "base64",
    "url"
   ],
   "type": "string",
   "default": "base64",
   "description": "base64 (default): the file comes back inline as base64. url: the file is stored for 24 hours and the reply carries a download link (url, expires_at, bytes, content_type, sha256) instead of the base64, which keeps the file out of your context window."
  },
  "gravity": {
   "enum": [
    "center",
    "north",
    "south",
    "east",
    "west",
    "northwest",
    "northeast",
    "southwest",
    "southeast"
   ],
   "type": "string",
   "default": "center",
   "description": "Aspect mode: the part to keep
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "box": {
   "top": 60,
   "left": 0,
   "width": 640,
   "height": 360
  },
  "bytes": 104465,
  "input": {
   "bytes": 161713,
   "width": 640,
   "format": "jpeg",
   "frames": 1,
   "height": 480,
   "animated": false,
   "has_alpha": false
  },
  "notes": [],
  "width": 640,
  "format": "jpeg",
  "height": 360,
  "source": {
   "url": "https://python-pillow.org",
   "library": "Pillow",
   "license": "MIT-CMU (HPND)"
  },
  "final_url": "https://raw.githubusercontent.com/ianare/exif-samples/master/jpg/gps/DSCN0010.jpg",
  "operation": "crop",
  "source_url": "https://raw.githubusercontent.com/ianare/exif-samples/master/jpg/gps/DSCN0010.jpg",
  "data_base64": "/9j/4AAQSkZJRgAB... (trimmed: 139,288 base64 characters in the reply)",
  "content_type": "image/jpeg"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-imagepeek-image-crop-0df12632/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)