Python SDK

pip install doconda

from doconda import Doconda

doconda = Doconda()  # reads the key from DOCONDA_API_KEY
doc = doconda.documents.create(format="docx", prompt="Report on the housing law")

print(doc["status"])  # "ready"
open("report.docx", "wb").write(doconda.documents.download(doc["id"], "docx"))

doconda.documents.create(
    format="pptx",
    prompt="Quarterly results for the board",
    style="dark blue headings, Lora font",
    quality="best",
)

doconda.documents.create(format="docx", content={"markdown": "# Minutes\n\nAttendees: …"})

doconda = Doconda(
    api_key="ak_eu_…",   # default: DOCONDA_API_KEY
    max_retries=2,       # retries on network errors, 429 and 5xx
    base_url=None,       # taken from the key: ak_eu_… → Europe, ak_us_… → US
    http_client=None,    # your httpx.Client (proxies, timeouts)
)

file = doconda.files.upload("contract.docx")  # a path, bytes (with filename) or an open file

reviewed = doconda.documents.create(operation="review", file=file["id"])
edited = doconda.documents.create(operation="edit", file=file["id"], prompt="blue headings and a confidentiality clause")

report = doconda.documents.report(edited["id"])  # problems, fixes and every change

text = doconda.extract("proposal.pdf")["markdown"]

for event in doconda.documents.stream(format="docx", prompt="Welcome letter"):
    print(event["type"])  # document.created … document.ready

tools = doconda.tools()                    # for a server
tools = doconda.tools(local_files=True)    # can also upload files from this computer

from doconda import verify_webhook

doconda.webhooks.create("https://your-app.com/doconda")  # returns the secret only this once

event = verify_webhook(request.body, request.headers, secret=WHSEC)  # raises ValueError if the signature doesn't match

from doconda import DocondaError

try:
    doconda.documents.create(format="docx", prompt="…")
except DocondaError as e:
    print(e.status, e.code, e.errors)