certivu-python

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

Install

pip install certivu

Quick start

from certivu import CertivuClient

client = CertivuClient(
    api_key="ctv_key_abc123",
    generator_id="your-generator-uuid",
)

# Sign AI-generated content — images, audio, or text; format auto-detected
result = client.sign(content=image_bytes, model="stable-diffusion-xl")
# result.signed_content — bytes of the signed file (serve this, not the original)
# result.token         — ctv_ provenance token
# result.format        — 'image' | 'audio' | 'text'

# Sign audio or text explicitly
result = client.sign(content=pdf_bytes, model="gpt-4o", format="text")

# 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])

Generator setup

1. Create a generator in the dashboard and select its supported formats (image, audio, text).

2. Copy the generator ID and your org API key.

3. Sign content — all cryptography (ML-DSA, watermarking, hashing) is handled server-side:

   result = client.sign(
       content=file_bytes,
       model="stable-diffusion-xl",
       generator_id="gen_xyz",
   )
   output_file.write(result.signed_content)
   

Confidence levels

Links

• API Reference
• Documentation
• Pricing