chronoverify 0.1.1

Client for the ChronoVerify image capture-time and provenance verification API.

chronoverify

Python client for the ChronoVerify image capture-time and provenance verification API. Send any image, get one plain verdict (provenance_confirmed, consistent, inconclusive, metadata_anomaly, or manipulation_indicated) with a 0 to 100 confidence and the signals behind it. It reads C2PA Content Credentials when present and falls back to EXIF, XMP, and pixel forensics when they are not, so it works on any image, signed or not.

Get an API key (the first 100 verifications each month are included, then a flat $0.003 per image, no per-operation multipliers): https://chronoverify.com/pricing

ChronoVerify is provenance-first and deliberately not a deepfake detector. Verdicts are investigative triage to support human review, not proof.

Install

pip install chronoverify

Use

from chronoverify import Client

client = Client("cv_live_...")          # or omit the key to use the free, rate-limited public path
result = client.verify(file="photo.jpg")

print(result["verdict"], result["confidence"])
print(result["capture_time"])           # {"value": "...", "source": "exif", ...}

Verify a remote image by URL (the server fetches it):

result = client.verify(url="https://example.com/photo.jpg")

You can pass a path, raw bytes, or an open binary file:

with open("photo.jpg", "rb") as fh:
    result = client.verify(file=fh)

The key can also come from the CHRONOVERIFY_API_KEY environment variable.

Signed audit report

Get a shareable, independently verifiable PDF audit record for one image (an Ed25519 signature over the canonical verdict, with an optional RFC 3161 timestamp). A report requires an API key. It is the premium artifact: included within a paid plan's monthly quota, otherwise $0.20 from your prepaid balance.

client.report(file="photo.jpg", out="report.pdf")   # writes the PDF, returns the path

pdf_bytes = client.report(file="photo.jpg")          # or get the raw bytes

Verify a report's signature against the public key at https://chronoverify.com/v1/key .

Command line

chronoverify verify photo.jpg
chronoverify verify --url https://example.com/photo.jpg
chronoverify verify photo.jpg --json
chronoverify report photo.jpg -o report.pdf

Set CHRONOVERIFY_API_KEY (or pass --key) to use a metered key; omit it for the free public path.

Response

The verdict object is documented in full, with field reference and examples, at https://chronoverify.com/method#api . A clean result means a file's saved data is internally consistent, not that the scene it shows is real.

License

MIT