AiSicario for Python

Official client for the AiSicario deposition platform.

pip install aisicario

import os
from aisicario import AiSicario

client = AiSicario(api_key=os.environ["AISICARIO_API_KEY"])

print(client.pricing())

for case in client.cases.list(limit=10)["data"]:
    print(case["name"])

proceeding = client.proceedings.create(case_id=case["id"], title="Witness deposition",
                                       witness_name="J. Doe", scheduled_at="2026-04-02T15:00:00Z")

lines = client.proceedings.transcript(proceeding["id"], limit=100)
client.proceedings.analyze(proceeding["id"])
client.translations.create(proceeding["id"], lang="es")

result = client.transcribe(audio_url="https://example.com/audio.m4a",
                           idempotency_key="session-1")
print(result["text"], result["billed_minutes"])

Sandbox

Create a sandbox key in Settings → Developers. Sandbox keys return realistic sample data and are never billed.

Webhooks

from aisicario import verify_webhook

ok = verify_webhook(
    secret=os.environ["AISICARIO_WEBHOOK_SECRET"],
    body=raw_request_body,
    timestamp=headers["X-AiSicario-Timestamp"],
    signature=headers["X-AiSicario-Signature"],
)

Events: transcription.finished, analysis.finished, proceeding.ended, exhibit.added, translation.ready, credits.low. Failed deliveries retry at 1, 5, 15, 60 and 180 minutes.

Errors

AiSicarioError carries status and message. 401 invalid key, 403 missing scope, 402 not enough credits, 429 rate limited (120 requests per minute per key).

Full reference: https://aisicario.me/developers