s2ar

certify

/v1/certify · $0.01 a call · 3 keyless calls a day · paid by x402, credits, mpp

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.

Call it

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.

Parameters

parametertyperequiredwhat
image_urlstringhttps URL of a PNG, JPEG or WebP up to 4 MB
image_b64stringthe image bytes, base64 (POST only)
probestringrecon (default), ocr, or auto
target_modelstringthe model whose reading must hold (default: the house witness)

The answer

{
 "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.

A worked example

certify a screenshot: the call, its answer and its record, re-derived.

The errors are the same on every route.