acretix-verify-sdk

Python client for the AI Verify API — submit work against a rubric and receive a scored, explained verdict with an Ed25519-signed, independently re-verifiable proof.

import os
from acretix_verify import AcretixVerify

client = AcretixVerify(api_key=os.environ["VERIFY_API_KEY"])

rubric = client.compile_rubric({
    "name": "invoice-check",
    "criteria": [
        {"key": "total_present", "type": "must_have", "primitive": "regex_match@1",
         "config": {"pattern": r"Total: \$[0-9]+"}},
    ],
})

verdict = client.submit_verification(
    rubric_id=rubric["rubric_id"],
    submission={"inline": "Invoice... Total: $420"},
    wait_ms=30000,
    idempotency_key="invoice-001",
)
# verdict["determination"]: "met" | "partial" | "not_met" — flagged=True means needs_review:
# below the confidence threshold the engine abstains rather than asserting a verdict.

report = client.reverify(verdict["verification_id"])
# report["ok"] and report["chain_ok"] — the proof verifies against the published public key.

• Verdicts below the confidence threshold are flagged needs_review — the engine abstains instead of guessing; your application decides what happens next.
• Proofs are signed with Ed25519 and re-verifiable by any third party against the published public key — see the docs for the proof format.
• Also available: get_verification, wait_for_verification, get_proof, get_usage, submit_feedback.
• Usage is metered per verification by judge tier.

Standard library only (urllib). Python 3.9+.

License: MIT