"""Great Work Labs client for Python. Only needs `requests`. Source: https://labs.greatwork.company/sdk/labs.py Docs: https://labs.greatwork.company/docs from labs import Labs labs = Labs() # reads GWL_API_KEY r = labs.run("veil-1", input="Email dana@example.com", redact="type") print(r["output"]["redacted"], r["usage"]["cost_usd"]) Models: lingo-1, tone-1, mood-1, spot-1, sort-1, topic-1, route-1, sieve-1, warden-1, moat-1, veil-1, bait-1, ground-1, atlas-1, ladder-1, pluck-1, glyph-1, comma-1, brief-1, mold-1, headline-1, scribe-1, prism-1, ink-1, scout-1, cutout-1, curtain-1 """ import json, os, time import requests BASE = "https://labs.greatwork.company/v1" class LabsError(Exception): def __init__(self, status, code, message, body): super().__init__(f"{status} {code}: {message}") self.status, self.code, self.body = status, code, body class Labs: def __init__(self, key=None, base=BASE, retries=3, timeout=300): self.key = key or os.environ.get("GWL_API_KEY") if not self.key: raise ValueError("Missing API key: pass key= or set GWL_API_KEY") self.base, self.retries, self.timeout = base, retries, timeout self.s = requests.Session() self.s.headers["Authorization"] = f"Bearer {self.key}" def run(self, model, input=None, file=None, idempotency_key=None, **options): """Run a model. input: str, list of str (batch), or an image/audio URL. file: an open file or path to upload.""" headers = {"Idempotency-Key": idempotency_key} if idempotency_key else {} for attempt in range(self.retries + 1): if file is not None: f = open(file, "rb") if isinstance(file, str) else file data = {"model": model, **{k: v if isinstance(v, str) else json.dumps(v) for k, v in options.items()}} res = self.s.post(f"{self.base}/run", data=data, files={"input": f}, headers=headers, timeout=self.timeout) else: res = self.s.post(f"{self.base}/run", json={"model": model, "input": input, **options}, headers=headers, timeout=self.timeout) if res.ok: return res.json() if res.status_code in (429, 503) and attempt < self.retries: time.sleep(0.5 * 2 ** attempt) continue body = res.json() if res.headers.get("content-type", "").startswith("application/json") else {} err = body.get("error", {}) raise LabsError(res.status_code, err.get("code"), err.get("message", res.text), body) def estimate(self, model, input=None, **options): return self.s.post(f"{self.base}/estimate", json={"model": model, "input": input, **options}, timeout=30).json() def account(self): return self.s.get(f"{self.base}/account", timeout=30).json() def models(self): return self.s.get(f"{self.base}/models", timeout=30).json()["data"]