Certify an image compression: the image (by URL, as base64 JSON, or as a multipart file part `original`) is compressed to the smallest version a vision model reads the same way, the drift is measured by a deterministic witness, and the answer is a signed Assay record anyone can verify free at /v1/verify/{record_sha256}. With a `compressed` part too, it audits a transform someone else made.
curl 'https://api.s2ar.dev/v1/certify?image_url=https%3A%2F%2Fs2ar.dev%2Fexamples%2Fmedia%2Finvoice.png&probe=ocr'
curl -X POST https://api.s2ar.dev/v1/certify \
-H 'content-type: application/json' \
-d '{"image_url": "https://s2ar.dev/examples/media/invoice.png", "probe": "ocr"}'
With a key: add -H 'Authorization: Bearer $S2AR_KEY'. Over x402, while sales are open: the same call at https://api.s2ar.dev/x402/v1/certify; unpaid, it answers 402 with the accepts[] to sign, then send the payment as PAYMENT-SIGNATURE (or X-PAYMENT). Sales are paused since 2026-10-16, and the mirror answers 410. From an agent: the MCP tool certify_image at https://api.s2ar.dev/mcp.
| parameter | type | required | what |
|---|---|---|---|
image_url | string | https URL of a PNG, JPEG or WebP up to 4 MB | |
image_b64 | string | the image bytes, base64 (POST only) | |
probe | string | recon (default), ocr, or auto | |
target_model | string | the model whose reading must hold (default: the house witness) |
{
"v": 2,
"issuer": "assay",
"kind": "compression",
"verdict": "isomorphic",
"outcome": "pass",
"record_sha256": "924aed0a…",
"charged_usd": 0.01,
"receipt": {
"evidence_hash": "sha256:94abfed2…",
"cost_usd": 0.01,
"what": "certify",
"determinism": "replayable",
"witnesses": [
"recon",
"phash",
"ocr"
],
"issued_at": "2026-10-10T00:00:00Z",
"refund_rule": "failed calls are never charged",
"charter": "https://api.s2ar.dev/charter"
}
}
Every paid answer carries its receipt; a record's sha256 re-verifies free at /v1/verify/{sha256}. A call that fails is never charged.
certify a screenshot: the call, its answer and its record, re-derived.
The errors are the same on every route.