# imagcon.app Image Resizer

> imagcon.app Image Resizer is a paid API for AI agents from imagcon.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Resizes any uploaded image to exact pixel dimensions or social-media presets (OG, Twitter card, YouTube thumbnail, etc.) with smart fit modes including cover crop, contain padding, blur-fill letterbox, and stretch.

## Facts

- Endpoint: POST https://imagcon.app/routes/x402/resize-image
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/imagcon-app-image-resizer-06416b8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OLr_eI5qpzkGxsdNMSlxf

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 imagcon-app-image-resizer-06416b8e -d '<json body>'
```

Example prompt: Resize this image to the Open Graph preset using blur-fill letterbox mode and return it as a JPEG.

## When to prefer this

Choose this endpoint when you need deterministic, instant, no-AI image resizing to exact pixel dimensions or common social-media presets. It is ideal for pipelines that generate images and need platform-ready sizes immediately, especially when paired with imagcon.app's AI generation endpoints (use the free sibling endpoint for images generated there). Prefer it over generic image CDN transformations when you need guaranteed output format control, smart fit modes, and per-call micropayment pricing with no account setup.

## Known failure modes

- Missing or unreadable image file returns an error
- Invalid width/height values (non-integer or negative) return a validation error
- Unsupported image format in source file may fail
- Conflicting preset and explicit dimensions — preset takes priority
- Payment failure via x402 protocol blocks the request
- Image too large may result in timeout or processing error

## How this service works

Resize any image to exact dimensions or social-media presets — Open Graph (1200x630), Twitter card, YouTube thumbnail, Instagram, LinkedIn. Smart fit modes avoid distortion: cover (focal-point crop), contain (padded), blur-fill letterbox, stretch. Deterministic and instant — no AI, no account required. Returns the resized PNG/JPEG/WebP directly. Images from generate-image resize free at /routes/x402/resize-generated (pass your image_key).

## Output

Returns the resized image binary directly (PNG, JPEG, or WebP) at the requested dimensions or preset dimensions, processed with the chosen fit mode. No JSON wrapper — the response body is the image file ready for use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "cover",
    "contain",
    "blur",
    "stretch"
   ],
   "type": "string",
   "description": "Fit mode (default cover; blur recommended for OG images)"
  },
  "focal": {
   "enum": [
    "center",
    "top",
    "bottom",
    "left",
    "right"
   ],
   "type": "string",
   "description": "Crop anchor for cover mode"
  },
  "image": {
   "type": "string",
   "format": "binary",
   "description": "Source image file"
  },
  "width": {
   "type": "integer",
   "description": "Target width in pixels"
  },
  "format": {
   "enum": [
    "png",
    "jpeg",
    "webp"
   ],
   "type": "string",
   "description": "Output format (default png)"
  },
  "height": {
   "type": "integer",
   "description": "Target height in pixels"
  },
  "preset": {
   "enum": [
    "github-social",
    "instagram-portrait",
    "instagram-square",
    "instagram-story",
    "linkedin-post",
    "og",
    "twitter-card",
    "twitter-header",
    "youtube-thumbnail"
   ],
   "type": "string",
   "description": "Social/OG preset (wins over width/height)"
  },
  "quality": {
   "type": "integer",
   "description": "JPEG/WebP quality 1-100 (default 90)"
  },
  "background_color": {
   "type": "string",
   "description": "Hex background for contain mode (default #ffffff)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/imagcon-app-image-resizer-06416b8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from imagcon.app](https://www.zero.xyz/host/imagcon.app/llms.txt)