ddukddak 1.0.0__tar.gz

ddukddak-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ddukddak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ddukddak-1.0.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: ddukddak
+Version: 1.0.0
+Summary: Python SDK for the Ddukddak image and video generation API
+License-Expression: MIT
+Project-URL: Homepage, https://ddukddak.studio
+Project-URL: Documentation, https://ddukddak.studio/quick-start
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: requests>=2.20.0
+Dynamic: license-file

ddukddak-1.0.0/README.md

@@ -0,0 +1,185 @@
+# ddukddak
+
+Official Python SDK for the [Ddukddak](https://ddukddak.studio) image and video generation API.
+
+## Installation
+
+```bash
+pip install ddukddak
+```
+
+## Quick Start
+
+```python
+from ddukddak import Ddukddak
+
+client = Ddukddak("your-api-key")
+
+# Generate an image from a template
+image = client.images.create(
+    template="template-uid",
+    properties={"title": "Hello World"},
+)
+
+print(image)
+```
+
+## Usage
+
+### Initialize
+
+```python
+client = Ddukddak("your-api-key")
+
+# With custom options
+client = Ddukddak(
+    "your-api-key",
+    base_url="https://api.ddukddak.studio/v1",
+    timeout=30,
+)
+```
+
+### Authentication
+
+```python
+# Verify your API key
+result = client.auth.test()
+```
+
+### Account
+
+```python
+account = client.account.get()
+```
+
+### Templates
+
+```python
+# List templates
+templates = client.templates.list(page=1, limit=25)
+
+# Get a specific template
+template = client.templates.get("template-uid")
+```
+
+### Images
+
+```python
+# Create an image
+image = client.images.create(
+    template="template-uid",
+    properties={"title": "Sale Banner", "price": "$9.99"},
+    transparent=False,
+)
+
+# Create and wait for completion
+image = client.images.create_and_wait(
+    template="template-uid",
+    properties={"title": "Sale Banner"},
+)
+
+# List images
+images = client.images.list(page=1, limit=25)
+
+# Get a specific image
+image = client.images.get("image-uid")
+```
+
+### Videos
+
+```python
+# Create a video
+video = client.videos.create(
+    template="template-uid",
+    input_media_url="https://example.com/video.mp4",
+    properties={"subtitle": "Hello"},
+)
+
+# Create and wait for completion
+video = client.videos.create_and_wait(
+    template="template-uid",
+    input_media_url="https://example.com/video.mp4",
+)
+
+# List videos
+videos = client.videos.list()
+
+# Get a specific video
+video = client.videos.get("video-uid")
+```
+
+### AI Images
+
+```python
+# Generate an AI image
+image = client.ai_images.create(
+    prompt="A sunset over the ocean",
+    model="gemini",
+    aspect_ratio="16:9",
+)
+
+# Generate and wait for completion
+image = client.ai_images.create_and_wait(
+    prompt="A sunset over the ocean",
+)
+```
+
+### AI Videos
+
+```python
+# Generate an AI video
+video = client.ai_videos.create(
+    prompt="A cat walking on the beach",
+    model="minimax",
+    aspect_ratio="16:9",
+    duration=5,
+)
+
+# Generate and wait for completion
+video = client.ai_videos.create_and_wait(
+    prompt="A cat walking on the beach",
+)
+```
+
+## Error Handling
+
+```python
+from ddukddak import (
+    Ddukddak,
+    AuthenticationError,
+    ValidationError,
+    RateLimitError,
+)
+
+try:
+    image = client.images.create(template="uid")
+except AuthenticationError:
+    # Invalid API key (401)
+    pass
+except ValidationError:
+    # Bad request (400)
+    pass
+except RateLimitError:
+    # Too many requests (429)
+    pass
+```
+
+All exception classes:
+
+| Class | Status Code | Description |
+|-------|------------|-------------|
+| `AuthenticationError` | 401 | Invalid or missing API key |
+| `ValidationError` | 400 | Invalid request parameters |
+| `QuotaExceededError` | 402 | Usage quota exceeded |
+| `PlanRestrictedError` | 403 | Feature not available on current plan |
+| `NotFoundError` | 404 | Resource not found |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `DdukddakError` | * | Base exception class |
+
+## Requirements
+
+- Python >= 3.8
+
+## License
+
+[MIT](LICENSE)

ddukddak-1.0.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ddukddak"
+version = "1.0.0"
+description = "Python SDK for the Ddukddak image and video generation API"
+requires-python = ">=3.8"
+license = "MIT"
+dependencies = ["requests>=2.20.0"]
+
+[project.urls]
+Homepage = "https://ddukddak.studio"
+Documentation = "https://ddukddak.studio/quick-start"
+
+[tool.setuptools.packages.find]
+where = ["src"]

ddukddak-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ddukddak-1.0.0/src/ddukddak/__init__.py

@@ -0,0 +1,22 @@
+from .client import Ddukddak
+from .exceptions import (
+    DdukddakError,
+    AuthenticationError,
+    RateLimitError,
+    NotFoundError,
+    ValidationError,
+    PlanRestrictedError,
+    QuotaExceededError,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "Ddukddak",
+    "DdukddakError",
+    "AuthenticationError",
+    "RateLimitError",
+    "NotFoundError",
+    "ValidationError",
+    "PlanRestrictedError",
+    "QuotaExceededError",
+]

ddukddak-1.0.0/src/ddukddak/client.py

@@ -0,0 +1,232 @@
+import time
+
+import requests
+
+from .exceptions import (
+    DdukddakError,
+    AuthenticationError,
+    ValidationError,
+    QuotaExceededError,
+    PlanRestrictedError,
+    NotFoundError,
+    RateLimitError,
+)
+
+_ERROR_MAP = {
+    400: ValidationError,
+    401: AuthenticationError,
+    402: QuotaExceededError,
+    403: PlanRestrictedError,
+    404: NotFoundError,
+    429: RateLimitError,
+}
+
+
+class _Resource:
+    def __init__(self, client):
+        self._client = client
+
+    def _request(self, method, path, **kwargs):
+        return self._client._request(method, path, **kwargs)
+
+
+class AuthResource(_Resource):
+    def test(self):
+        return self._request("GET", "/auth")
+
+
+class AccountResource(_Resource):
+    def get(self):
+        return self._request("GET", "/account")
+
+
+class TemplatesResource(_Resource):
+    def list(self, page=1, limit=25):
+        return self._request("GET", "/templates", params={"page": page, "limit": limit})
+
+    def get(self, uid):
+        return self._request("GET", f"/templates/{uid}")
+
+
+class ImagesResource(_Resource):
+    def create(self, template, properties=None, webhook_url=None, transparent=False):
+        body = {"template": template}
+        if properties:
+            body["properties"] = properties
+        if webhook_url:
+            body["webhook_url"] = webhook_url
+        if transparent:
+            body["transparent"] = transparent
+        return self._request("POST", "/images", json=body)
+
+    def list(self, page=1, limit=25):
+        return self._request("GET", "/images", params={"page": page, "limit": limit})
+
+    def get(self, uid):
+        return self._request("GET", f"/images/{uid}")
+
+    def create_and_wait(self, template, properties=None, transparent=False, poll_interval=3, timeout=300):
+        result = self.create(template, properties=properties, transparent=transparent)
+        if result.get("status") in ("completed", "failed"):
+            return result
+        return self._poll(result["uid"], poll_interval, timeout)
+
+    def _poll(self, uid, interval, timeout):
+        start = time.time()
+        while time.time() - start < timeout:
+            result = self.get(uid)
+            if result.get("status") in ("completed", "failed"):
+                return result
+            time.sleep(interval)
+        raise DdukddakError(f"Polling timed out after {timeout}s for image {uid}")
+
+
+class VideosResource(_Resource):
+    def create(self, template, input_media_url, properties=None, audio_url=None, webhook_url=None):
+        body = {"template": template, "input_media_url": input_media_url}
+        if properties:
+            body["properties"] = properties
+        if audio_url:
+            body["audio_url"] = audio_url
+        if webhook_url:
+            body["webhook_url"] = webhook_url
+        return self._request("POST", "/videos", json=body)
+
+    def list(self, page=1, limit=25):
+        return self._request("GET", "/videos", params={"page": page, "limit": limit})
+
+    def get(self, uid):
+        return self._request("GET", f"/videos/{uid}")
+
+    def create_and_wait(self, template, input_media_url, properties=None, audio_url=None, poll_interval=5, timeout=600):
+        result = self.create(template, input_media_url, properties=properties, audio_url=audio_url)
+        if result.get("status") in ("completed", "failed"):
+            return result
+        return self._poll(result["uid"], poll_interval, timeout)
+
+    def _poll(self, uid, interval, timeout):
+        start = time.time()
+        while time.time() - start < timeout:
+            result = self.get(uid)
+            if result.get("status") in ("completed", "failed"):
+                return result
+            time.sleep(interval)
+        raise DdukddakError(f"Polling timed out after {timeout}s for video {uid}")
+
+
+class AiImagesResource(_Resource):
+    def create(self, prompt=None, model=None, aspect_ratio=None, image_size=None, settings=None, template=None, webhook_url=None):
+        body = {}
+        if prompt:
+            body["prompt"] = prompt
+        if model:
+            body["model"] = model
+        if aspect_ratio:
+            body["aspect_ratio"] = aspect_ratio
+        if image_size:
+            body["image_size"] = image_size
+        if settings:
+            body["settings"] = settings
+        if template:
+            body["template"] = template
+        if webhook_url:
+            body["webhook_url"] = webhook_url
+        return self._request("POST", "/ai/images", json=body)
+
+    def list(self, page=1, limit=25):
+        return self._request("GET", "/ai/images", params={"page": page, "limit": limit})
+
+    def get(self, uid):
+        return self._request("GET", f"/ai/images/{uid}")
+
+    def create_and_wait(self, prompt=None, model=None, aspect_ratio=None, image_size=None, settings=None, template=None, poll_interval=3, timeout=300):
+        result = self.create(prompt=prompt, model=model, aspect_ratio=aspect_ratio, image_size=image_size, settings=settings, template=template)
+        if result.get("status") in ("completed", "failed"):
+            return result
+        return self._poll(result["uid"], poll_interval, timeout)
+
+    def _poll(self, uid, interval, timeout):
+        start = time.time()
+        while time.time() - start < timeout:
+            result = self.get(uid)
+            if result.get("status") in ("completed", "failed"):
+                return result
+            time.sleep(interval)
+        raise DdukddakError(f"Polling timed out after {timeout}s for AI image {uid}")
+
+
+class AiVideosResource(_Resource):
+    def create(self, prompt, model=None, aspect_ratio=None, resolution=None, duration=None, webhook_url=None):
+        body = {"prompt": prompt}
+        if model:
+            body["model"] = model
+        if aspect_ratio:
+            body["aspect_ratio"] = aspect_ratio
+        if resolution:
+            body["resolution"] = resolution
+        if duration:
+            body["duration"] = duration
+        if webhook_url:
+            body["webhook_url"] = webhook_url
+        return self._request("POST", "/ai/videos", json=body)
+
+    def list(self, page=1, limit=25):
+        return self._request("GET", "/ai/videos", params={"page": page, "limit": limit})
+
+    def get(self, uid):
+        return self._request("GET", f"/ai/videos/{uid}")
+
+    def create_and_wait(self, prompt, model=None, aspect_ratio=None, resolution=None, duration=None, poll_interval=5, timeout=600):
+        result = self.create(prompt, model=model, aspect_ratio=aspect_ratio, resolution=resolution, duration=duration)
+        if result.get("status") in ("completed", "failed"):
+            return result
+        return self._poll(result["uid"], poll_interval, timeout)
+
+    def _poll(self, uid, interval, timeout):
+        start = time.time()
+        while time.time() - start < timeout:
+            result = self.get(uid)
+            if result.get("status") in ("completed", "failed"):
+                return result
+            time.sleep(interval)
+        raise DdukddakError(f"Polling timed out after {timeout}s for AI video {uid}")
+
+
+class Ddukddak:
+    def __init__(self, api_key, base_url="https://api.ddukddak.studio/v1", timeout=30):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+        self.auth = AuthResource(self)
+        self.account = AccountResource(self)
+        self.templates = TemplatesResource(self)
+        self.images = ImagesResource(self)
+        self.videos = VideosResource(self)
+        self.ai_images = AiImagesResource(self)
+        self.ai_videos = AiVideosResource(self)
+
+    def _request(self, method, path, **kwargs):
+        url = f"{self.base_url}{path}"
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+        }
+        if "headers" in kwargs:
+            headers.update(kwargs.pop("headers"))
+
+        response = requests.request(
+            method, url, headers=headers, timeout=self.timeout, **kwargs
+        )
+
+        if response.status_code >= 400:
+            try:
+                data = response.json()
+            except ValueError:
+                data = {}
+            error_code = data.get("error", "unknown_error")
+            message = data.get("message", response.text)
+            exc_class = _ERROR_MAP.get(response.status_code, DdukddakError)
+            raise exc_class(message, status_code=response.status_code, error_code=error_code)
+
+        return response.json()

ddukddak-1.0.0/src/ddukddak/exceptions.py

@@ -0,0 +1,30 @@
+class DdukddakError(Exception):
+    def __init__(self, message, status_code=None, error_code=None):
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+        self.error_code = error_code
+
+
+class AuthenticationError(DdukddakError):
+    pass
+
+
+class ValidationError(DdukddakError):
+    pass
+
+
+class QuotaExceededError(DdukddakError):
+    pass
+
+
+class PlanRestrictedError(DdukddakError):
+    pass
+
+
+class NotFoundError(DdukddakError):
+    pass
+
+
+class RateLimitError(DdukddakError):
+    pass

ddukddak-1.0.0/src/ddukddak.egg-info/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: ddukddak
+Version: 1.0.0
+Summary: Python SDK for the Ddukddak image and video generation API
+License-Expression: MIT
+Project-URL: Homepage, https://ddukddak.studio
+Project-URL: Documentation, https://ddukddak.studio/quick-start
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: requests>=2.20.0
+Dynamic: license-file

ddukddak-1.0.0/src/ddukddak.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/ddukddak/__init__.py
+src/ddukddak/client.py
+src/ddukddak/exceptions.py
+src/ddukddak.egg-info/PKG-INFO
+src/ddukddak.egg-info/SOURCES.txt
+src/ddukddak.egg-info/dependency_links.txt
+src/ddukddak.egg-info/requires.txt
+src/ddukddak.egg-info/top_level.txt

ddukddak-1.0.0/src/ddukddak.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ddukddak-1.0.0/src/ddukddak.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.20.0

ddukddak-1.0.0/src/ddukddak.egg-info/top_level.txt

@@ -0,0 +1 @@
+ddukddak