delula-sdk 0.1.0__py3-none-any.whl

delula_sdk/__init__.py

@@ -0,0 +1,6 @@
+"""Delula Public API SDK (beta)."""
+
+from delula_sdk.client import DelulaClient
+from delula_sdk.errors import DelulaApiError
+
+__all__ = ["DelulaClient", "DelulaApiError"]

delula_sdk/client.py

@@ -0,0 +1,122 @@
+from __future__ import annotations
+
+import json
+import time
+import uuid
+from typing import Any
+from urllib import error, request
+
+from delula_sdk.errors import DelulaApiError
+
+DEFAULT_BASE_URL = "https://delu.la/public/api"
+
+
+class DelulaClient:
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL) -> None:
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        body: dict[str, Any] | None = None,
+        extra_headers: dict[str, str] | None = None,
+    ) -> Any:
+        url = f"{self.base_url}{path}"
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Accept": "application/json",
+        }
+        data: bytes | None = None
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+            data = json.dumps(body).encode("utf-8")
+        if extra_headers:
+            headers.update(extra_headers)
+        req = request.Request(url, data=data, headers=headers, method=method)
+        try:
+            with request.urlopen(req, timeout=120) as res:
+                payload = res.read().decode("utf-8")
+                return json.loads(payload) if payload else {}
+        except error.HTTPError as exc:
+            raw = exc.read().decode("utf-8")
+            try:
+                parsed = json.loads(raw)
+            except json.JSONDecodeError:
+                parsed = {}
+            raise DelulaApiError(
+                exc.code,
+                parsed.get("code", "internal_error"),
+                parsed.get("message", exc.reason),
+                parsed.get("details"),
+            ) from exc
+
+    def get_account(self) -> dict[str, Any]:
+        return self._request("GET", "/account")
+
+    def get_credits(self) -> dict[str, Any]:
+        return self._request("GET", "/account/credits")
+
+    def list_recipes(self, lang: str = "en") -> dict[str, Any]:
+        return self._request("GET", f"/recipes?lang={lang}")
+
+    def get_recipe(self, recipe_id: int, lang: str = "en") -> dict[str, Any]:
+        return self._request("GET", f"/recipes/{recipe_id}?lang={lang}")
+
+    def preflight_generation(
+        self, recipe_id: int, form_data: dict[str, Any] | None = None
+    ) -> dict[str, Any]:
+        return self._request(
+            "POST",
+            "/generations/preflight",
+            {"recipeId": recipe_id, "formData": form_data or {}},
+        )
+
+    def create_generation(
+        self,
+        recipe_id: int,
+        form_data: dict[str, Any] | None = None,
+        parameters: dict[str, Any] | None = None,
+        idempotency_key: str | None = None,
+    ) -> dict[str, Any]:
+        key = idempotency_key or str(uuid.uuid4())
+        return self._request(
+            "POST",
+            "/generations",
+            {
+                "recipeId": recipe_id,
+                "formData": form_data or {},
+                "parameters": parameters or {},
+            },
+            extra_headers={"Idempotency-Key": key},
+        )
+
+    def get_generation(self, generation_id: int) -> dict[str, Any]:
+        return self._request("GET", f"/generations/{generation_id}")
+
+    def list_generations(
+        self,
+        page: int = 1,
+        limit: int = 20,
+        status: str | None = None,
+    ) -> dict[str, Any]:
+        query = f"page={page}&limit={limit}"
+        if status:
+            query += f"&status={status}"
+        return self._request("GET", f"/generations?{query}")
+
+    def wait_for_generation(
+        self,
+        generation_id: int,
+        interval_s: float = 3.0,
+        timeout_s: float = 600.0,
+    ) -> dict[str, Any]:
+        started = time.time()
+        while True:
+            gen = self.get_generation(generation_id)
+            if gen.get("status") in ("completed", "failed"):
+                return gen
+            if time.time() - started > timeout_s:
+                raise DelulaApiError(408, "internal_error", f"Timed out waiting for generation {generation_id}")
+            time.sleep(interval_s)

delula_sdk/errors.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+class DelulaApiError(Exception):
+    def __init__(
+        self,
+        status: int,
+        code: str,
+        message: str,
+        details: dict[str, Any] | None = None,
+    ) -> None:
+        super().__init__(message)
+        self.status = status
+        self.code = code
+        self.details = details or {}

delula_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: delula-sdk
+Version: 0.1.0
+Summary: Delula Public API SDK (beta)
+Author: Delula
+License: Proprietary
+Project-URL: Homepage, https://delu.la
+Project-URL: Repository, https://github.com/tcotten-scrypted/MagicVidCreator
+Project-URL: Issues, https://github.com/tcotten-scrypted/MagicVidCreator/issues
+Keywords: delula,api,generative-ai,video,image
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# delula-sdk
+
+Python client for the [Delula Public API](https://delu.la) (beta).
+
+## Install
+
+```bash
+pip install delula-sdk
+```
+
+Requires Python **3.10+**. No third-party dependencies (stdlib only).
+
+## Quick start
+
+Create an API key in Delula → **Account → API**, then:
+
+```python
+import uuid
+from delula_sdk import DelulaClient
+
+client = DelulaClient(api_key="dlu_...")
+
+credits = client.get_credits()
+recipes = client.list_recipes()["recipes"]
+preflight = client.preflight_generation(recipes[0]["id"], form_data={})
+gen = client.create_generation(
+    recipes[0]["id"],
+    form_data={},
+    idempotency_key=str(uuid.uuid4()),
+)
+result = client.wait_for_generation(gen["generationId"])
+```
+
+Default base URL: `https://delu.la/public/api`. Pass `base_url=` for local dev.
+
+## Beta
+
+Breaking changes may ship in `0.x` without a `/v1` path bump. Pin your version in production.

delula_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+delula_sdk/__init__.py,sha256=FFyZ_rrKyi5CTUg3C7a5af0E29Hni1bJIYYKkaICkgo,171
+delula_sdk/client.py,sha256=1XFi__ihBMRPEELWBTzwtHp52vkAKUg9c5V5qcpZFH4,4051
+delula_sdk/errors.py,sha256=H1rm3oNOZsYEDQwLriPKWrJ-C46Ad04epZ5EOOjbUZI,375
+delula_sdk-0.1.0.dist-info/METADATA,sha256=kTC2GjwjGDwW1X0cWADq1k15EGd5I1zmqnhprQDpCDI,1686
+delula_sdk-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+delula_sdk-0.1.0.dist-info/top_level.txt,sha256=_J90_biR1-AKkIJApQ4Qu9tF7BmD4vPgIZnsnkKDgKY,11
+delula_sdk-0.1.0.dist-info/RECORD,,

delula_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

delula_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+delula_sdk