pic·to·man·cy · noun

The art of turning heavy images into light ones.

Practiced over HTTP. Resize, compress and convert images with a single request — processed in under 50 ms, from $0.001 per image.

Get your API keyRead the docs
your first spell
curl -X POST https://api.pictomancer.ai/v1/compress \
  -H "Content-Type: application/json" \
  -d '{"source": "https://your.site/hero.jpg", "q": 80}'

Your first 50 requests are free. No card, no account.

Proof

One image, one request, receipts included.

This demo was produced by the public API. The two files below are the input and the output of the request on the receipt — drag to compare.

Original photograph of Hopetoun Falls, 2.9 MB JPEG
Same photograph optimized by Pictomancer, 439 KB WebP
⇄
JPEG · 2.9 MBWebP · 439 KB

Original 3072×2048, displayed at 1920 px. Photo: David Iliff, CC BY-SA 3.0.

RECEIPT

requestPOST /v1/pipeline

resize ×0.625 → convert webp q=80

input2,954,043 bytes

3072×2048 · JPEG

output438,968 bytes

1920×1280 · WebP

saved85.1%

2.5 MB less on the wire

billed$0.0045

$0.003 base × 1.5 size multiplier

Run on the public API, July 18, 2026. One request, billed as one operation.

Operations

Six operations, one flat price each.

Latency is measured on the processing core, per operation. Know the cost before you commit — analyze is free.

OperationWhat it doesAvg latencyBase price
ANALYZEFREE
Free metadata fetch. Know costs before committing.—$0.00
RESIZE
Scale by factor or dimensions. Cover/contain/fill.<12ms$0.001
COMPRESS
60–90% size reduction, fine-grained quality.<22ms$0.001
CROP
Precise region extraction.<12ms$0.001
CONVERT
JPEG↔PNG↔WebP↔TIFF↔GIF↔AVIF with quality control.<18ms$0.002+
PIPELINE
Chain up to 10 operations. Billed as one.<48mssum
How it works

Three steps, no ceremony.

It is a plain HTTP API. If you can send a POST request, you can optimize images.

STEP 1GET A KEY

Create an API key in the dashboard — or skip it entirely: your first 50 requests are free, no account needed.

STEP 2SEND YOUR IMAGE

POST a URL or base64 payload to /v1/resize, /v1/compress, /v1/convert, /v1/crop — or chain them in /v1/pipeline.

STEP 3RECEIVE THE RESULT

Optimized bytes come back in the response, or we PUT them straight into your bucket. Processing takes under 50 ms.

Code

Copy, paste, optimized.

Plain REST, an official Python SDK, MCP for agents, or generate your own client from the OpenAPI spec.

curl -X POST https://api.pictomancer.ai/v1/resize \
  -H "Authorization: Bearer $PICTOMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "https://example.com/photo.jpg",
    "scale": 0.5,
    "format": "webp"
  }' --output photo.webp
Delivery

Process once, deliver anywhere.

Return optimized bytes inline, PUT them straight into your bucket, or have them POSTed to your endpoint. Your credentials never reach us.

{ "mode": "inline" }

Default · response body

Optimized bytes returned in the same response. Sub-50 ms. Good for plugins and small images.

{ "mode": "put_url" }

Your bucket · presigned PUT

You sign the URL on your side. We PUT the result there. Zero credentials on our infrastructure, ever.

{ "mode": "callback_url" }

Your endpoint · webhook POST

We POST the optimized bytes to your endpoint, with a SHA-256 integrity header and optional HMAC signature.

AWS S3
Cloudflare R2
Google Cloud
Azure Blob
Backblaze B2
DO Spaces
· or any S3-compatible storage
Integrations

Four ways in, today.

Everything listed here works right now. No vaporware badges.

REST API

OpenAPI 3.x spec, generate clients in any language

Read the docs →

Python SDK

pip install pictomancer

View on PyPI →

WordPress plugin

Optimizes uploads and thumbnails, composes with offload plugins

Set it up →

MCP server

One config block connects Claude, Cursor, or any MCP client

Connect →

Shipping next

PHP SDK on Packagist · Node SDK · Next.js image loader · n8n node

Pricing

A subscription when you scale, a meter when you don't.

Monthly plans for steady workloads. Pay-per-request for everything else — including agents paying per image with USDC.

FREE
$0

50 requests to try everything. No card, no account.

  • ·Every operation
  • ·Full API access
  • ·analyze is always free
Try it now
DEV
€15/month

50,000 images per month for products in development and small sites.

  • ·API keys
  • ·Usage dashboard
  • ·Email support
Start with Dev
PRO
€149/month

1,000,000 images per month for production workloads.

  • ·Everything in Dev
  • ·Priority processing
  • ·Priority support
Start with Pro
ENTERPRISE
Custom

More than 10M images, SLAs, and custom delivery targets.

  • ·Volume pricing
  • ·SLA
  • ·Direct line to us
Talk to us

PAY-PER-REQUEST

No plan, no commitment: $0.001–$0.03 per image, billed as base price × size multiplier. Agents can pay per request with USDC via x402 — no account involved.

resize, 500KB image$0.001
convert, 3MB image$0.003
pipeline (3 ops), 7MB image$0.008

analyze is always free · no data retention · pipeline billed as one operation

For agents

Your agent can use this without you.

Discovery, tools, and payment are all machine-readable. An agent can find Pictomancer, read the contract, pay per image, and get to work — 50 free requests included.

MCP

Six tools over Streamable HTTP. Works with Claude, Cursor, and any MCP client. Listed in the official MCP Registry.

https://api.pictomancer.ai/mcp
A2A

Agent card with skills and payment spec, discoverable at the well-known URL. Protocol version 1.0.

https://api.pictomancer.ai/.well-known/agent.json
x402

HTTP 402 answers with a price. The agent pays USDC on Base and retries. No account, no key, ~2s settlement.

402 → pay → 200

Cast your first spell.

50 free requests, no card. Your images come back lighter in under 50 ms.

Get your API keyRead the docs