SDK de Python

pip install doconda

from doconda import Doconda

doconda = Doconda()  # lee la key de DOCONDA_API_KEY
doc = doconda.documents.create(format="docx", prompt="Informe de la ley de vivienda")

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

doconda.documents.create(
    format="pptx",
    prompt="Resultados del trimestre para el comité",
    style="títulos azul oscuro, fuente Lora",
    quality="best",
)

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

doconda = Doconda(
    api_key="ak_eu_…",   # por defecto, DOCONDA_API_KEY
    max_retries=2,       # reintentos ante errores de red, 429 y 5xx
    base_url=None,       # por defecto, https://api.eu.doconda.com/v1
    http_client=None,    # tu httpx.Client (proxies, timeouts), también para descargar
    language=None,       # "es": mensajes en español; por defecto, en inglés
)

file = doconda.files.upload("contrato.docx")  # una ruta, bytes (con filename) o un fichero abierto

revisado = doconda.documents.create(operation="review", file=file["id"])
editado = doconda.documents.create(operation="edit", file=file["id"], prompt="títulos azules y una cláusula de confidencialidad")

informe = doconda.documents.report(editado["id"])  # problemas, arreglos y cada cambio

texto = doconda.extract("propuesta.pdf")["markdown"]

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

tools = doconda.tools()                    # para un servidor
tools = doconda.tools(local_files=True)    # además puede subir ficheros de este ordenador

import os

from doconda import verify_webhook

endpoint = doconda.webhooks.create("https://tu-app.com/doconda")
print(endpoint["secret"])  # sale solo esta vez: guárdalo, por ejemplo en DOCONDA_WEBHOOK_SECRET


def recibir_aviso(cuerpo: bytes, cabeceras: dict[str, str]) -> dict:
    # el cuerpo tal como llega (sin parsear el JSON) y las cabeceras del POST, de tu framework
    secret = os.environ["DOCONDA_WEBHOOK_SECRET"]
    return verify_webhook(cuerpo, cabeceras, secret)  # lanza ValueError si la firma no cuadra

from doconda import DocondaError

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