bannerify 0.1.0__tar.gz

bannerify-0.1.0/PKG-INFO

@@ -0,0 +1,273 @@
+Metadata-Version: 2.3
+Name: bannerify
+Version: 0.1.0
+Summary: Official Python SDK for Bannerify API - Generate images and PDFs at scale
+Keywords: bannerify,image generation,pdf generation,api
+Author: Duc An
+Author-email: Duc An <an@bannerify.co>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Python: >=3.8
+Project-URL: Documentation, https://bannerify.co/docs
+Project-URL: Homepage, https://bannerify.co
+Project-URL: Issues, https://github.com/bannerify/bannerify-python/issues
+Project-URL: Repository, https://github.com/bannerify/bannerify-python
+Description-Content-Type: text/markdown
+
+# Bannerify Python SDK
+
+Official Python SDK for [Bannerify](https://bannerify.co) - Generate images and PDFs at scale via API.
+
+[![PyPI version](https://badge.fury.io/py/bannerify.svg)](https://badge.fury.io/py/bannerify)
+[![Python versions](https://img.shields.io/pypi/pyversions/bannerify.svg)](https://pypi.org/project/bannerify/)
+
+## Installation
+
+```bash
+pip install bannerify
+```
+
+Or with uv:
+
+```bash
+uv add bannerify
+```
+
+## Quick Start
+
+```python
+from bannerify import BannerifyClient
+
+# Create client with your API key
+client = BannerifyClient("your-api-key")
+
+# Generate an image
+result = client.create_image(
+    "tpl_xxxxxxxxx",
+    modifications=[
+        {"name": "title", "text": "Hello World"},
+        {"name": "subtitle", "text": "From Python SDK"}
+    ]
+)
+
+if "result" in result:
+    with open("output.png", "wb") as f:
+        f.write(result["result"])
+    print("Image created successfully!")
+else:
+    print(f"Error: {result['error']['message']}")
+```
+
+## Features
+
+- 🚀 Simple, intuitive API
+- 🔒 Type-safe with full type hints
+- ⚡ Built on httpx for performance
+- 🎯 Result/Error pattern for explicit error handling
+- 📝 Comprehensive documentation
+- ✅ Well-tested
+
+## Usage
+
+### Creating Images
+
+```python
+# Generate PNG
+result = client.create_image(
+    "tpl_xxxxxxxxx",
+    modifications=[
+        {"name": "title", "text": "My Title"},
+        {"name": "image", "src": "https://example.com/image.jpg"}
+    ]
+)
+
+# Generate SVG
+result = client.create_image(
+    "tpl_xxxxxxxxx",
+    format="svg",
+    modifications=[{"name": "title", "text": "My Title"}]
+)
+
+# Generate thumbnail
+result = client.create_image("tpl_xxxxxxxxx", thumbnail=True)
+```
+
+### Creating PDFs
+
+```python
+result = client.create_pdf(
+    "tpl_xxxxxxxxx",
+    modifications=[{"name": "title", "text": "Invoice #123"}]
+)
+
+if "result" in result:
+    with open("invoice.pdf", "wb") as f:
+        f.write(result["result"])
+```
+
+### Generating Signed URLs
+
+```python
+signed_url = client.generate_image_signed_url(
+    "tpl_xxxxxxxxx",
+    modifications=[{"name": "title", "text": "Dynamic Title"}],
+    format="png"
+)
+
+# Use in HTML
+print(f"<img src='{signed_url}' alt='Generated Image' />")
+```
+
+### Error Handling
+
+```python
+result = client.create_image("tpl_xxxxxxxxx")
+
+if "error" in result:
+    error = result["error"]
+    print(f"Error Code: {error['code']}")
+    print(f"Message: {error['message']}")
+    print(f"Docs: {error['docs']}")
+else:
+    # Process result
+    image_data = result["result"]
+```
+
+### Context Manager
+
+```python
+with BannerifyClient("your-api-key") as client:
+    result = client.create_image("tpl_xxxxxxxxx")
+    # Client is automatically closed
+```
+
+## API Reference
+
+### BannerifyClient
+
+```python
+BannerifyClient(
+    api_key: str,
+    base_url: str = "https://api.bannerify.co/v1",
+    timeout: float = 60.0
+)
+```
+
+### create_image
+
+```python
+client.create_image(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None,
+    format: str = "png",
+    thumbnail: bool = False
+) -> Dict[str, Any]
+```
+
+### create_pdf
+
+```python
+client.create_pdf(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None
+) -> Dict[str, Any]
+```
+
+### create_stored_image
+
+```python
+client.create_stored_image(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None,
+    format: str = "png",
+    thumbnail: bool = False
+) -> Dict[str, Any]
+```
+
+### generate_image_signed_url
+
+```python
+client.generate_image_signed_url(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None,
+    format: str = "png",
+    thumbnail: bool = False,
+    nocache: bool = False
+) -> str
+```
+
+## Examples
+
+### Generate Multiple Images
+
+```python
+products = [
+    {"name": "Product A", "price": "$29.99"},
+    {"name": "Product B", "price": "$39.99"},
+]
+
+for i, product in enumerate(products):
+    result = client.create_image(
+        "tpl_product_banner",
+        modifications=[
+            {"name": "product_name", "text": product["name"]},
+            {"name": "price", "text": product["price"]}
+        ]
+    )
+    
+    if "result" in result:
+        with open(f"banner_{i}.png", "wb") as f:
+            f.write(result["result"])
+```
+
+### Email Campaigns
+
+```python
+for recipient in recipients:
+    signed_url = client.generate_image_signed_url(
+        "tpl_email_header",
+        modifications=[{"name": "name", "text": f"Hi, {recipient['name']}!"}]
+    )
+    # Use signed_url in email HTML
+```
+
+## Development
+
+```bash
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Type checking
+uv run mypy src/
+
+# Format code
+uv run ruff format src/
+```
+
+## Documentation
+
+Full documentation available at [https://bannerify.co/docs/sdk/python/overview](https://bannerify.co/docs/sdk/python/overview)
+
+## Support
+
+- Documentation: https://bannerify.co/docs
+- Issues: https://github.com/bannerify/bannerify-python/issues
+- Email: support@bannerify.co
+
+## License
+
+MIT License - see LICENSE file for details

bannerify-0.1.0/README.md

@@ -0,0 +1,246 @@
+# Bannerify Python SDK
+
+Official Python SDK for [Bannerify](https://bannerify.co) - Generate images and PDFs at scale via API.
+
+[![PyPI version](https://badge.fury.io/py/bannerify.svg)](https://badge.fury.io/py/bannerify)
+[![Python versions](https://img.shields.io/pypi/pyversions/bannerify.svg)](https://pypi.org/project/bannerify/)
+
+## Installation
+
+```bash
+pip install bannerify
+```
+
+Or with uv:
+
+```bash
+uv add bannerify
+```
+
+## Quick Start
+
+```python
+from bannerify import BannerifyClient
+
+# Create client with your API key
+client = BannerifyClient("your-api-key")
+
+# Generate an image
+result = client.create_image(
+    "tpl_xxxxxxxxx",
+    modifications=[
+        {"name": "title", "text": "Hello World"},
+        {"name": "subtitle", "text": "From Python SDK"}
+    ]
+)
+
+if "result" in result:
+    with open("output.png", "wb") as f:
+        f.write(result["result"])
+    print("Image created successfully!")
+else:
+    print(f"Error: {result['error']['message']}")
+```
+
+## Features
+
+- 🚀 Simple, intuitive API
+- 🔒 Type-safe with full type hints
+- ⚡ Built on httpx for performance
+- 🎯 Result/Error pattern for explicit error handling
+- 📝 Comprehensive documentation
+- ✅ Well-tested
+
+## Usage
+
+### Creating Images
+
+```python
+# Generate PNG
+result = client.create_image(
+    "tpl_xxxxxxxxx",
+    modifications=[
+        {"name": "title", "text": "My Title"},
+        {"name": "image", "src": "https://example.com/image.jpg"}
+    ]
+)
+
+# Generate SVG
+result = client.create_image(
+    "tpl_xxxxxxxxx",
+    format="svg",
+    modifications=[{"name": "title", "text": "My Title"}]
+)
+
+# Generate thumbnail
+result = client.create_image("tpl_xxxxxxxxx", thumbnail=True)
+```
+
+### Creating PDFs
+
+```python
+result = client.create_pdf(
+    "tpl_xxxxxxxxx",
+    modifications=[{"name": "title", "text": "Invoice #123"}]
+)
+
+if "result" in result:
+    with open("invoice.pdf", "wb") as f:
+        f.write(result["result"])
+```
+
+### Generating Signed URLs
+
+```python
+signed_url = client.generate_image_signed_url(
+    "tpl_xxxxxxxxx",
+    modifications=[{"name": "title", "text": "Dynamic Title"}],
+    format="png"
+)
+
+# Use in HTML
+print(f"<img src='{signed_url}' alt='Generated Image' />")
+```
+
+### Error Handling
+
+```python
+result = client.create_image("tpl_xxxxxxxxx")
+
+if "error" in result:
+    error = result["error"]
+    print(f"Error Code: {error['code']}")
+    print(f"Message: {error['message']}")
+    print(f"Docs: {error['docs']}")
+else:
+    # Process result
+    image_data = result["result"]
+```
+
+### Context Manager
+
+```python
+with BannerifyClient("your-api-key") as client:
+    result = client.create_image("tpl_xxxxxxxxx")
+    # Client is automatically closed
+```
+
+## API Reference
+
+### BannerifyClient
+
+```python
+BannerifyClient(
+    api_key: str,
+    base_url: str = "https://api.bannerify.co/v1",
+    timeout: float = 60.0
+)
+```
+
+### create_image
+
+```python
+client.create_image(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None,
+    format: str = "png",
+    thumbnail: bool = False
+) -> Dict[str, Any]
+```
+
+### create_pdf
+
+```python
+client.create_pdf(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None
+) -> Dict[str, Any]
+```
+
+### create_stored_image
+
+```python
+client.create_stored_image(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None,
+    format: str = "png",
+    thumbnail: bool = False
+) -> Dict[str, Any]
+```
+
+### generate_image_signed_url
+
+```python
+client.generate_image_signed_url(
+    template_id: str,
+    modifications: Optional[List[Dict[str, Any]]] = None,
+    format: str = "png",
+    thumbnail: bool = False,
+    nocache: bool = False
+) -> str
+```
+
+## Examples
+
+### Generate Multiple Images
+
+```python
+products = [
+    {"name": "Product A", "price": "$29.99"},
+    {"name": "Product B", "price": "$39.99"},
+]
+
+for i, product in enumerate(products):
+    result = client.create_image(
+        "tpl_product_banner",
+        modifications=[
+            {"name": "product_name", "text": product["name"]},
+            {"name": "price", "text": product["price"]}
+        ]
+    )
+    
+    if "result" in result:
+        with open(f"banner_{i}.png", "wb") as f:
+            f.write(result["result"])
+```
+
+### Email Campaigns
+
+```python
+for recipient in recipients:
+    signed_url = client.generate_image_signed_url(
+        "tpl_email_header",
+        modifications=[{"name": "name", "text": f"Hi, {recipient['name']}!"}]
+    )
+    # Use signed_url in email HTML
+```
+
+## Development
+
+```bash
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Type checking
+uv run mypy src/
+
+# Format code
+uv run ruff format src/
+```
+
+## Documentation
+
+Full documentation available at [https://bannerify.co/docs/sdk/python/overview](https://bannerify.co/docs/sdk/python/overview)
+
+## Support
+
+- Documentation: https://bannerify.co/docs
+- Issues: https://github.com/bannerify/bannerify-python/issues
+- Email: support@bannerify.co
+
+## License
+
+MIT License - see LICENSE file for details

bannerify-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "bannerify"
+version = "0.1.0"
+description = "Official Python SDK for Bannerify API - Generate images and PDFs at scale"
+readme = "README.md"
+authors = [{ name = "Duc An", email = "an@bannerify.co" }]
+requires-python = ">=3.8"
+dependencies = ["httpx>=0.27.0", "pydantic>=2.0", "python-dotenv>=1.0.1"]
+license = { text = "MIT" }
+keywords = ["bannerify", "image generation", "pdf generation", "api"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.urls]
+Homepage = "https://bannerify.co"
+Documentation = "https://bannerify.co/docs"
+Repository = "https://github.com/bannerify/bannerify-python"
+Issues = "https://github.com/bannerify/bannerify-python/issues"
+
+[build-system]
+requires = ["uv_build>=0.8.23,<0.9.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = ["datamodel-code-generator>=0.27.3"]

bannerify-0.1.0/src/bannerify/__init__.py

@@ -0,0 +1,7 @@
+"""Bannerify Python SDK - Generate images and PDFs at scale"""
+
+from .client import BannerifyClient
+from .models import Modification
+
+__version__ = "0.1.0"
+__all__ = ["BannerifyClient", "Modification"]

bannerify-0.1.0/src/bannerify/client.py

@@ -0,0 +1,338 @@
+"""Bannerify Client for Python"""
+
+import hashlib
+import json
+from typing import Any, Dict, List, Optional, Union
+from urllib.parse import urlencode
+
+import httpx
+from pydantic import TypeAdapter
+
+from .models import Modification
+
+
+class BannerifyClient:
+    """Bannerify API Client
+    
+    A simple, developer-friendly client for the Bannerify API.
+    Generate images and PDFs from templates at scale.
+    
+    Example:
+        >>> client = BannerifyClient("your-api-key")
+        >>> result = client.create_image("tpl_xxx", modifications=[
+        ...     {"name": "title", "text": "Hello World"}
+        ... ])
+        >>> if "result" in result:
+        ...     with open("output.png", "wb") as f:
+        ...         f.write(result["result"])
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.bannerify.co/v1",
+        timeout: float = 60.0,
+    ):
+        """Initialize the Bannerify client
+        
+        Args:
+            api_key: Your Bannerify API key
+            base_url: API base URL (default: https://api.bannerify.co/v1)
+            timeout: Request timeout in seconds (default: 60.0)
+        """
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self._client = httpx.Client(
+            timeout=timeout,
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "User-Agent": "bannerify-python/0.1.0",
+            },
+        )
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+
+    def close(self):
+        """Close the HTTP client"""
+        self._client.close()
+
+    def create_image(
+        self,
+        template_id: str,
+        modifications: Optional[List[Union[Modification, Dict[str, Any]]]] = None,
+        format: str = "png",
+        thumbnail: bool = False,
+    ) -> Dict[str, Any]:
+        """Generate an image from a template
+        
+        Args:
+            template_id: Template ID (e.g., 'tpl_xxxxxxxxx')
+            modifications: List of modifications to apply
+            format: Output format - 'png' or 'svg' (default: 'png')
+            thumbnail: Generate thumbnail version (default: False)
+            
+        Returns:
+            Dict with either 'result' (bytes) or 'error' (dict)
+            
+        Example:
+            >>> result = client.create_image(
+            ...     "tpl_xxx",
+            ...     modifications=[{"name": "title", "text": "Hello"}],
+            ...     format="png"
+            ... )
+        """
+        try:
+            # Convert modifications to dicts if they're Pydantic models
+            mods_list = []
+            if modifications:
+                for mod in modifications:
+                    if isinstance(mod, Modification):
+                        mods_list.append(mod.model_dump(exclude_none=True))
+                    else:
+                        mods_list.append(mod)
+            
+            payload = {
+                "apiKey": self.api_key,
+                "templateId": template_id,
+                "modifications": mods_list,
+                "format": format,
+                "thumbnail": thumbnail,
+            }
+
+            response = self._client.post(
+                f"{self.base_url}/templates/createImage",
+                json=payload,
+            )
+
+            if response.status_code == 200:
+                content_type = response.headers.get("content-type", "")
+                
+                if "image/svg" in content_type:
+                    return {"result": response.text}
+                else:
+                    return {"result": response.content}
+
+            # Handle error responses
+            if response.headers.get("content-type", "").startswith("application/json"):
+                error_data = response.json()
+                if "error" in error_data:
+                    return {"error": error_data["error"]}
+            
+            return self._build_error(
+                "HTTP_ERROR",
+                f"HTTP {response.status_code}: {response.text[:100]}"
+            )
+
+        except httpx.TimeoutException:
+            return self._build_error("TIMEOUT", "Request timed out")
+        except httpx.RequestError as e:
+            return self._build_error("REQUEST_ERROR", str(e))
+        except Exception as e:
+            return self._build_error("EXCEPTION", str(e))
+
+    def create_pdf(
+        self,
+        template_id: str,
+        modifications: Optional[List[Union[Modification, Dict[str, Any]]]] = None,
+    ) -> Dict[str, Any]:
+        """Generate a PDF from a template
+        
+        Args:
+            template_id: Template ID
+            modifications: List of modifications to apply
+            
+        Returns:
+            Dict with either 'result' (bytes) or 'error' (dict)
+        """
+        try:
+            # Convert modifications to dicts if they're Pydantic models
+            mods_list = []
+            if modifications:
+                for mod in modifications:
+                    if isinstance(mod, Modification):
+                        mods_list.append(mod.model_dump(exclude_none=True))
+                    else:
+                        mods_list.append(mod)
+            
+            payload = {
+                "apiKey": self.api_key,
+                "templateId": template_id,
+                "modifications": mods_list,
+            }
+
+            response = self._client.post(
+                f"{self.base_url}/templates/createPdf",
+                json=payload,
+            )
+
+            if response.status_code == 200:
+                return {"result": response.content}
+
+            # Handle error responses
+            if response.headers.get("content-type", "").startswith("application/json"):
+                error_data = response.json()
+                if "error" in error_data:
+                    return {"error": error_data["error"]}
+            
+            return self._build_error(
+                "HTTP_ERROR",
+                f"HTTP {response.status_code}: {response.text[:100]}"
+            )
+
+        except httpx.TimeoutException:
+            return self._build_error("TIMEOUT", "Request timed out")
+        except httpx.RequestError as e:
+            return self._build_error("REQUEST_ERROR", str(e))
+        except Exception as e:
+            return self._build_error("EXCEPTION", str(e))
+
+    def create_stored_image(
+        self,
+        template_id: str,
+        modifications: Optional[List[Union[Modification, Dict[str, Any]]]] = None,
+        format: str = "png",
+        thumbnail: bool = False,
+    ) -> Dict[str, Any]:
+        """Create an image and store it on Bannerify's CDN
+        
+        Args:
+            template_id: Template ID
+            modifications: List of modifications to apply
+            format: Output format - 'png' or 'svg'
+            thumbnail: Generate thumbnail version
+            
+        Returns:
+            Dict with either 'result' (URL string) or 'error' (dict)
+        """
+        try:
+            # Convert modifications to dicts if they're Pydantic models
+            mods_list = []
+            if modifications:
+                for mod in modifications:
+                    if isinstance(mod, Modification):
+                        mods_list.append(mod.model_dump(exclude_none=True))
+                    else:
+                        mods_list.append(mod)
+            
+            payload = {
+                "apiKey": self.api_key,
+                "templateId": template_id,
+                "modifications": mods_list,
+                "format": format,
+                "thumbnail": thumbnail,
+            }
+
+            response = self._client.post(
+                f"{self.base_url}/templates/createStoredImage",
+                json=payload,
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                return {"result": data.get("url")}
+
+            # Handle error responses
+            if response.headers.get("content-type", "").startswith("application/json"):
+                error_data = response.json()
+                if "error" in error_data:
+                    return {"error": error_data["error"]}
+            
+            return self._build_error(
+                "HTTP_ERROR",
+                f"HTTP {response.status_code}: {response.text[:100]}"
+            )
+
+        except httpx.TimeoutException:
+            return self._build_error("TIMEOUT", "Request timed out")
+        except httpx.RequestError as e:
+            return self._build_error("REQUEST_ERROR", str(e))
+        except Exception as e:
+            return self._build_error("EXCEPTION", str(e))
+
+    def generate_image_signed_url(
+        self,
+        template_id: str,
+        modifications: Optional[List[Union[Modification, Dict[str, Any]]]] = None,
+        format: str = "png",
+        thumbnail: bool = False,
+        nocache: bool = False,
+    ) -> str:
+        """Generate a signed URL for on-demand image generation
+        
+        Args:
+            template_id: Template ID
+            modifications: List of modifications to apply
+            format: Output format - 'png' or 'svg'
+            thumbnail: Generate thumbnail version
+            nocache: Bypass cache
+            
+        Returns:
+            The signed URL string
+            
+        Example:
+            >>> url = client.generate_image_signed_url(
+            ...     "tpl_xxx",
+            ...     modifications=[{"name": "title", "text": "Dynamic"}]
+            ... )
+            >>> print(f"<img src='{url}' />")
+        """
+        # Hash the API key
+        api_key_hashed = hashlib.sha256(self.api_key.encode()).hexdigest()
+
+        params = {
+            "apiKeyHashed": api_key_hashed,
+            "templateId": template_id,
+        }
+
+        if format == "svg":
+            params["format"] = "svg"
+
+        if modifications:
+            # Convert modifications to dicts if they're Pydantic models
+            mods_list = []
+            for mod in modifications:
+                if isinstance(mod, Modification):
+                    mods_list.append(mod.model_dump(exclude_none=True))
+                else:
+                    mods_list.append(mod)
+            params["modifications"] = json.dumps(mods_list)
+
+        if nocache:
+            params["nocache"] = "true"
+
+        if thumbnail:
+            params["thumbnail"] = "true"
+
+        # Sort parameters
+        sorted_params = dict(sorted(params.items()))
+
+        # Generate signature
+        query_string = urlencode(sorted_params)
+        sign_input = query_string + api_key_hashed
+        sign = hashlib.sha256(sign_input.encode()).hexdigest()
+        sorted_params["sign"] = sign
+
+        return f"{self.base_url}/templates/signedurl?{urlencode(sorted_params)}"
+
+    def _build_error(self, code: str, message: str) -> Dict[str, Any]:
+        """Build an error response
+        
+        Args:
+            code: Error code
+            message: Error message
+            
+        Returns:
+            Error dict
+        """
+        return {
+            "error": {
+                "code": code,
+                "message": message,
+                "docs": "https://bannerify.co/docs",
+            }
+        }

bannerify-0.1.0/src/bannerify/models.py

@@ -0,0 +1,291 @@
+# generated by datamodel-codegen:
+#   filename:  openapi.json
+#   timestamp: 2025-11-14T19:40:03+00:00
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class Code(Enum):
+    BAD_REQUEST = 'BAD_REQUEST'
+
+
+class Error(BaseModel):
+    code: Code = Field(
+        ..., description='A machine readable error code.', example='BAD_REQUEST'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/BAD_REQUEST',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrBadRequest(BaseModel):
+    error: Error
+
+
+class Code1(Enum):
+    FETCH_IMAGE_ERROR = 'FETCH_IMAGE_ERROR'
+
+
+class Error1(BaseModel):
+    code: Code1 = Field(
+        ..., description='A machine readable error code.', example='FETCH_IMAGE_ERROR'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/FETCH_IMAGE_ERROR',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrFetchImageError(BaseModel):
+    error: Error1
+
+
+class Code2(Enum):
+    UNAUTHORIZED = 'UNAUTHORIZED'
+
+
+class Error2(BaseModel):
+    code: Code2 = Field(
+        ..., description='A machine readable error code.', example='UNAUTHORIZED'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/UNAUTHORIZED',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrUnauthorized(BaseModel):
+    error: Error2
+
+
+class Code3(Enum):
+    FORBIDDEN = 'FORBIDDEN'
+
+
+class Error3(BaseModel):
+    code: Code3 = Field(
+        ..., description='A machine readable error code.', example='FORBIDDEN'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/FORBIDDEN',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrForbidden(BaseModel):
+    error: Error3
+
+
+class Code4(Enum):
+    NOT_FOUND = 'NOT_FOUND'
+
+
+class Error4(BaseModel):
+    code: Code4 = Field(
+        ..., description='A machine readable error code.', example='NOT_FOUND'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/NOT_FOUND',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrNotFound(BaseModel):
+    error: Error4
+
+
+class Code5(Enum):
+    CONFLICT = 'CONFLICT'
+
+
+class Error5(BaseModel):
+    code: Code5 = Field(
+        ..., description='A machine readable error code.', example='CONFLICT'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/CONFLICT',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrConflict(BaseModel):
+    error: Error5
+
+
+class Code6(Enum):
+    TOO_MANY_REQUESTS = 'TOO_MANY_REQUESTS'
+
+
+class Error6(BaseModel):
+    code: Code6 = Field(
+        ..., description='A machine readable error code.', example='TOO_MANY_REQUESTS'
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/TOO_MANY_REQUESTS',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrTooManyRequests(BaseModel):
+    error: Error6
+
+
+class Code7(Enum):
+    INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR'
+
+
+class Error7(BaseModel):
+    code: Code7 = Field(
+        ...,
+        description='A machine readable error code.',
+        example='INTERNAL_SERVER_ERROR',
+    )
+    docs: str = Field(
+        ...,
+        description='A link to our documentation with more details about this error code',
+        example='https://documentation.bannerify.co/api-reference/errors/code/INTERNAL_SERVER_ERROR',
+    )
+    message: str = Field(
+        ..., description='A human readable explanation of what went wrong'
+    )
+    requestId: str = Field(
+        ...,
+        description='Please always include the requestId in your error report',
+        example='req:1234',
+    )
+
+
+class ErrInternalServerError(BaseModel):
+    error: Error7
+
+
+class WidthMode(Enum):
+    standard = 'standard'
+    adaptive = 'adaptive'
+
+
+class HeightMode(Enum):
+    standard = 'standard'
+    adaptive = 'adaptive'
+
+
+class Theme(Enum):
+    NONE = 'NONE'
+    DEFAULT = 'DEFAULT'
+    BRIGHT = 'BRIGHT'
+    SIMPLIFY = 'SIMPLIFY'
+    ARCO = 'ARCO'
+
+
+class Modification(BaseModel):
+    name: str = Field(
+        ..., description='The layer name of the modification', example='Text 1'
+    )
+    color: Optional[str] = Field(
+        None, description='The color for the modification', example='#FF0000'
+    )
+    src: Optional[str] = Field(
+        None,
+        description='The source image for the modification',
+        example='https://example.com/image.jpg',
+    )
+    text: Optional[str] = Field(
+        None,
+        description='You can modify the text layer with this field',
+        example='Hello World',
+    )
+    barcode: Optional[str] = Field(
+        None,
+        description='Modify the barcode layer content with this field',
+        example='1234567890',
+    )
+    qrcode: Optional[str] = Field(
+        None,
+        description='Modify the qrcode layer content with this field',
+        example='Some text',
+    )
+    chart: Optional[Dict[str, Any]] = Field(
+        None, description="Update chart layer's data, follow chart.js data structure"
+    )
+    visible: Optional[bool] = Field(
+        None, description='Set the visibility of the field', example=True
+    )
+    star: Optional[float] = Field(None, description='Star value', example=5)
+    widthMode: Optional[WidthMode] = Field(
+        None, description='Table width mode', example='adaptive'
+    )
+    heightMode: Optional[HeightMode] = Field(
+        None, description='Table height mode', example='adaptive'
+    )
+    theme: Optional[Theme] = Field(None, description='Table theme', example='NONE')
+    rows: Optional[List[Any]] = Field(None, description='Table rows')
+    columns: Optional[List[str]] = Field(None, description='Table columns')