certivu 1.2.0

Python SDK for Certivu — quantum-resistant trust infrastructure for AI-generated content

certivu-python

Python SDK for Certivu — quantum-resistant trust infrastructure for AI-generated content.

Install

pip install certivu          # verify-only (httpx + pydantic)
pip install certivu[signing] # + ML-DSA signing (dilithium-py)

Quick start

from certivu import CertivuClient

client = CertivuClient(
    api_key="ctv_key_abc123",
    generator_id="your-generator-uuid",
    private_key="base64-ml-dsa-private-key",  # requires certivu[signing]
)

# Sign AI-generated content
result = client.sign(content=image_bytes, model="stable-diffusion-xl")
print(result.token)  # ctv_7f3kx9mq2... — embed in XMP metadata

# Verify — no API key needed, always free
result = client.verify(content=image_bytes)
if result.authentic and result.confidence == "high":
    print(result.provenance.org, result.provenance.signed_at)

# Verify without re-uploading the image
status = client.get_token_status("ctv_7f3kx9mq2...")

# Batch verify
results = client.verify_batch([
    {"content": image1_bytes},
    {"content": image2_bytes, "token": "ctv_..."},
])

# Audit log
page = client.get_audit_log(page=1, limit=50)

Async

from certivu import AsyncCertivuClient

async with AsyncCertivuClient(api_key="ctv_key_abc123") as client:
    result = await client.verify(content=image_bytes)
    results = await client.verify_batch([{"content": img} for img in images])

Signing setup

1. Generate a keypair via the dashboard or API:

   keypair = client.generate_keypair()
   # Save keypair.private_key immediately — never stored by Certivu
   

2. Register the generator in your dashboard with the public key.

3. Sign content:

   result = client.sign(
       content=image_bytes,
       model="stable-diffusion-xl",
       generator_id=keypair_id,
       private_key=keypair.private_key,
   )
   

Confidence levels

Confidence	Meaning
high	Watermark ✓ + Record ✓ + Signature ✓ — full chain intact
medium	Record ✓ + Signature ✓ — re-uploaded without watermark
low	Partial signals — something is off
none	Not signed by Certivu — no claim either way

Links

• API Reference
• Documentation
• Pricing