llamagen-python 0.1.7__tar.gz → 0.1.8__tar.gz

{llamagen_python-0.1.7 → llamagen_python-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llamagen-python
-Version: 0.1.7
+Version: 0.1.8
 Summary: Official Python SDK for LlamaGen Comic API and Animation API
 Project-URL: Homepage, https://llamagen.ai/comic-api
 Project-URL: Documentation, https://llamagen.ai/comic-api/docs
@@ -23,7 +23,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 
-# llamagen-python
+# LlamaGen Python SDK
 
 Official Python SDK for LlamaGen's Comic API and Animation API.
 
@@ -53,6 +53,9 @@ LLAMAGEN_API_KEY=YOUR_API_KEY
 
 ## Quick Start
 
+This example creates one comic generation and waits for the final result. API
+generation calls consume credits.
+
 ```python
 import os
 
@@ -78,8 +81,28 @@ done = client.comic.wait_for_completion(created["id"], timeout_ms=WAIT_TIMEOUT_M
 print("comic.wait_for_completion:", done["id"], done.get("status"), done.get("comics"))
 ```
 
+The full runnable demo is in [`examples/quickstart.py`](examples/quickstart.py):
+
+```bash
+python examples/quickstart.py
+```
+
+Pass a local image path to run the upload example:
+
+```bash
+python examples/quickstart.py upload /path/to/reference.png
+```
+
+Other README examples are available as subcommands, such as `comic-create`,
+`comic-create-advanced`, `comic-get`, `comic-wait`, `comic-create-and-wait`,
+`comic-continue`, `comic-update-panel`, `usage`, `animation-create`,
+`animation-create-wait`, `animation-wait`, and `animation-create-and-wait`.
 
-## Client
+All Python examples below are self-contained for copy/paste usage. Replace
+`YOUR_COMIC_ID` or `YOUR_ANIMATION_ID` with an existing generation ID when an
+example fetches, waits for, continues, or updates an existing job.
+
+## Configure The Client
 
 ```python
 from llamagen import LlamaGenClient
@@ -101,6 +124,8 @@ dependencies.
 Use `llamagen.comic` to create comics, manga, webtoons, storyboards,
 consistent-character pages, and panel edits.
 
+Create with advanced options:
+
 ```python
 import os
 
@@ -271,14 +296,15 @@ from llamagen import LlamaGenClient
 
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
-upload_file = os.environ.get("LLAMAGEN_UPLOAD_FILE")
-if upload_file:
-    uploaded = client.comic.upload(Path(upload_file))
-    print("comic.upload:", uploaded)
+image_path = Path("reference.png")
+uploaded = client.comic.upload(image_path)
+print("comic.upload:", uploaded)
 ```
 
 ## Animation API
 
+Create an animation job and wait for completion:
+
 ```python
 import os
 
@@ -294,12 +320,14 @@ video = client.animation.create({
         "aspect_ratio": "16:9",
     },
 })
+print("animation.create:", video["id"], video.get("status"))
 
 finished = client.animation.wait_for_completion(
     video["id"],
     interval_ms=5000,
     timeout_ms=30 * 60 * 1000,
 )
+print("animation.wait_for_completion:", finished["id"], finished.get("status"))
 ```
 
 Animation methods:
@@ -311,6 +339,8 @@ Animation methods:
 
 Animation examples:
 
+Create an animation job:
+
 ```python
 import os
 
@@ -327,7 +357,6 @@ video = client.animation.create({
     },
 })
 print("animation.create:", video["id"], video.get("status"))
-
 ```
 
 Fetch and wait for an animation:
@@ -369,10 +398,13 @@ finished = client.animation.create_and_wait({
     },
 }, timeout_ms=WAIT_TIMEOUT_MS)
 print("animation.create_and_wait:", finished["id"], finished.get("status"))
-
 ```
 
-## Errors
+## Error Handling
+
+API errors include the HTTP status, parsed server response, and a readable
+message. For example, a `429` response can include an error code and message
+such as insufficient credits.
 
 ```python
 import os

{llamagen_python-0.1.7 → llamagen_python-0.1.8}/README.md

@@ -1,4 +1,4 @@
-# llamagen-python
+# LlamaGen Python SDK
 
 Official Python SDK for LlamaGen's Comic API and Animation API.
 
@@ -28,6 +28,9 @@ LLAMAGEN_API_KEY=YOUR_API_KEY
 
 ## Quick Start
 
+This example creates one comic generation and waits for the final result. API
+generation calls consume credits.
+
 ```python
 import os
 
@@ -53,8 +56,28 @@ done = client.comic.wait_for_completion(created["id"], timeout_ms=WAIT_TIMEOUT_M
 print("comic.wait_for_completion:", done["id"], done.get("status"), done.get("comics"))
 ```
 
+The full runnable demo is in [`examples/quickstart.py`](examples/quickstart.py):
+
+```bash
+python examples/quickstart.py
+```
+
+Pass a local image path to run the upload example:
+
+```bash
+python examples/quickstart.py upload /path/to/reference.png
+```
+
+Other README examples are available as subcommands, such as `comic-create`,
+`comic-create-advanced`, `comic-get`, `comic-wait`, `comic-create-and-wait`,
+`comic-continue`, `comic-update-panel`, `usage`, `animation-create`,
+`animation-create-wait`, `animation-wait`, and `animation-create-and-wait`.
 
-## Client
+All Python examples below are self-contained for copy/paste usage. Replace
+`YOUR_COMIC_ID` or `YOUR_ANIMATION_ID` with an existing generation ID when an
+example fetches, waits for, continues, or updates an existing job.
+
+## Configure The Client
 
 ```python
 from llamagen import LlamaGenClient
@@ -76,6 +99,8 @@ dependencies.
 Use `llamagen.comic` to create comics, manga, webtoons, storyboards,
 consistent-character pages, and panel edits.
 
+Create with advanced options:
+
 ```python
 import os
 
@@ -246,14 +271,15 @@ from llamagen import LlamaGenClient
 
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
-upload_file = os.environ.get("LLAMAGEN_UPLOAD_FILE")
-if upload_file:
-    uploaded = client.comic.upload(Path(upload_file))
-    print("comic.upload:", uploaded)
+image_path = Path("reference.png")
+uploaded = client.comic.upload(image_path)
+print("comic.upload:", uploaded)
 ```
 
 ## Animation API
 
+Create an animation job and wait for completion:
+
 ```python
 import os
 
@@ -269,12 +295,14 @@ video = client.animation.create({
         "aspect_ratio": "16:9",
     },
 })
+print("animation.create:", video["id"], video.get("status"))
 
 finished = client.animation.wait_for_completion(
     video["id"],
     interval_ms=5000,
     timeout_ms=30 * 60 * 1000,
 )
+print("animation.wait_for_completion:", finished["id"], finished.get("status"))
 ```
 
 Animation methods:
@@ -286,6 +314,8 @@ Animation methods:
 
 Animation examples:
 
+Create an animation job:
+
 ```python
 import os
 
@@ -302,7 +332,6 @@ video = client.animation.create({
     },
 })
 print("animation.create:", video["id"], video.get("status"))
-
 ```
 
 Fetch and wait for an animation:
@@ -344,10 +373,13 @@ finished = client.animation.create_and_wait({
     },
 }, timeout_ms=WAIT_TIMEOUT_MS)
 print("animation.create_and_wait:", finished["id"], finished.get("status"))
-
 ```
 
-## Errors
+## Error Handling
+
+API errors include the HTTP status, parsed server response, and a readable
+message. For example, a `429` response can include an error code and message
+such as insufficient credits.
 
 ```python
 import os

llamagen_python-0.1.8/examples/quickstart.py

@@ -0,0 +1,279 @@
+import argparse
+import os
+from pathlib import Path
+
+from llamagen import (
+    LlamaGenAPIError,
+    LlamaGenClient,
+    LlamaGenConnectionError,
+    LlamaGenTimeoutError,
+)
+
+
+ROOT = Path(__file__).resolve().parents[1]
+WAIT_TIMEOUT_MS = 30 * 60 * 1000
+
+
+def load_dotenv(path: Path) -> None:
+    if not path.exists():
+        return
+
+    for raw_line in path.read_text(encoding="utf-8").splitlines():
+        line = raw_line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, value = line.split("=", 1)
+        os.environ.setdefault(key.strip(), value.strip().strip('"').strip("'"))
+
+
+def make_client() -> LlamaGenClient:
+    load_dotenv(ROOT / ".env")
+    return LlamaGenClient(
+        api_key=os.environ["LLAMAGEN_API_KEY"],
+        timeout_ms=30000,
+        max_retries=5,
+        retry_delay_ms=500,
+    )
+
+
+def quick_start(client: LlamaGenClient) -> None:
+    created = client.comic.create(
+        {
+            "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
+            "style": "manga",
+            "fixPanelNum": 4,
+        }
+    )
+    print("comic.create:", created["id"], created.get("status"))
+
+    done = client.comic.wait_for_completion(created["id"], timeout_ms=WAIT_TIMEOUT_MS)
+    print("comic.wait_for_completion:", done["id"], done.get("status"), done.get("comics"))
+
+
+def create_comic(client: LlamaGenClient) -> None:
+    created = client.comic.create(
+        {
+            "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
+            "style": "manga",
+            "fixPanelNum": 4,
+        }
+    )
+    print("comic.create:", created["id"], created.get("status"))
+
+
+def create_comic_with_advanced_options(client: LlamaGenClient) -> None:
+    generation = client.comic.create(
+        {
+            "prompt": "The Little Prince meets the Fox in a luminous desert.",
+            "style": "storybook manga",
+            "size": "1024x1024",
+            "pagination": {"totalPages": 2, "panelsPerPage": 4},
+            "comicRoles": [
+                {
+                    "name": "The Little Prince",
+                    "image": "https://example.com/prince.png",
+                    "clothing": "green coat and yellow scarf",
+                }
+            ],
+            "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
+            "language": "en",
+            "upscale": "2K",
+        }
+    )
+    print("comic.create advanced:", generation["id"], generation.get("status"))
+
+
+def get_comic(client: LlamaGenClient, comic_id: str) -> None:
+    fetched = client.comic.get(comic_id)
+    print("comic.get:", fetched["id"], fetched.get("status"))
+
+    panel = client.comic.get(comic_id, page=0, panel=0)
+    print("comic.get panel:", panel.get("id", comic_id), panel.get("status"))
+
+
+def wait_for_comic(client: LlamaGenClient, comic_id: str) -> None:
+    done = client.comic.wait_for_completion(comic_id, timeout_ms=WAIT_TIMEOUT_MS)
+    print("comic.wait_for_completion:", done["id"], done.get("status"), done.get("comics"))
+
+
+def create_and_wait_for_comic(client: LlamaGenClient) -> None:
+    finished = client.comic.create_and_wait(
+        {
+            "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
+            "style": "storybook",
+            "fixPanelNum": 3,
+        },
+        timeout_ms=WAIT_TIMEOUT_MS,
+    )
+    print("comic.create_and_wait:", finished["id"], finished.get("status"))
+
+
+def continue_comic(client: LlamaGenClient, comic_id: str) -> None:
+    continued = client.comic.continue_write(
+        comic_id,
+        {
+            "prompt": "Continue the story with Leo opening a secret reading room.",
+            "pagination": {"totalPages": 1, "panelsPerPage": 4},
+        },
+    )
+    print("comic.continue_write:", continued["id"], continued.get("status"))
+
+
+def update_comic_panel(client: LlamaGenClient, comic_id: str) -> None:
+    updated = client.comic.update_panel(
+        comic_id,
+        {
+            "panelIndex": 0,
+            "prompt": "Make the glowing key brighter and add dramatic moonlight.",
+        },
+    )
+    print("comic.update_panel:", updated["id"], updated.get("status"))
+
+
+def show_usage(client: LlamaGenClient) -> None:
+    usage = client.comic.usage()
+    print("comic.usage:", usage)
+
+
+def upload_reference_image(client: LlamaGenClient, image_path: Path) -> None:
+    uploaded = client.comic.upload(image_path)
+    print("comic.upload:", uploaded)
+
+
+def create_animation(client: LlamaGenClient) -> None:
+    video = client.animation.create(
+        {
+            "prompt": "A heroic fox detective walks through neon rain, cinematic camera move.",
+            "videoOptions": {
+                "duration": 5,
+                "resolution": "720p",
+                "aspect_ratio": "16:9",
+            },
+        }
+    )
+    print("animation.create:", video["id"], video.get("status"))
+
+
+def create_and_wait_for_animation_with_manual_wait(client: LlamaGenClient) -> None:
+    video = client.animation.create(
+        {
+            "prompt": "A heroic fox detective walks through neon rain, cinematic camera move.",
+            "videoOptions": {
+                "duration": 5,
+                "resolution": "720p",
+                "aspect_ratio": "16:9",
+            },
+        }
+    )
+    print("animation.create:", video["id"], video.get("status"))
+
+    finished = client.animation.wait_for_completion(
+        video["id"],
+        interval_ms=5000,
+        timeout_ms=WAIT_TIMEOUT_MS,
+    )
+    print("animation.wait_for_completion:", finished["id"], finished.get("status"))
+
+
+def create_and_wait_for_animation(client: LlamaGenClient) -> None:
+    finished = client.animation.create_and_wait(
+        {
+            "prompt": "A paper boat sailing across a watercolor city at sunrise.",
+            "videoOptions": {
+                "duration": 5,
+                "resolution": "720p",
+                "aspect_ratio": "16:9",
+            },
+        },
+        timeout_ms=WAIT_TIMEOUT_MS,
+    )
+    print("animation.create_and_wait:", finished["id"], finished.get("status"))
+
+
+def wait_for_animation(client: LlamaGenClient, animation_id: str) -> None:
+    fetched = client.animation.get(animation_id)
+    print("animation.get:", fetched["id"], fetched.get("status"))
+
+    finished = client.animation.wait_for_completion(animation_id, timeout_ms=WAIT_TIMEOUT_MS)
+    print("animation.wait_for_completion:", finished["id"], finished.get("status"))
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Run LlamaGen Python SDK examples.")
+    subparsers = parser.add_subparsers(dest="command")
+
+    subparsers.add_parser("quickstart", help="Create one comic and wait for completion.")
+    subparsers.add_parser("comic-create", help="Create one comic generation.")
+    subparsers.add_parser("comic-create-advanced", help="Create a comic with advanced options.")
+    subparsers.add_parser("comic-create-and-wait", help="Create one comic and wait in one call.")
+    subparsers.add_parser("usage", help="Fetch comic API usage.")
+
+    get_parser = subparsers.add_parser("comic-get", help="Fetch a comic generation, page, and panel.")
+    get_parser.add_argument("comic_id")
+
+    wait_parser = subparsers.add_parser("comic-wait", help="Wait for a comic generation.")
+    wait_parser.add_argument("comic_id")
+
+    continue_parser = subparsers.add_parser("comic-continue", help="Continue an existing comic.")
+    continue_parser.add_argument("comic_id")
+
+    update_parser = subparsers.add_parser("comic-update-panel", help="Regenerate one panel.")
+    update_parser.add_argument("comic_id")
+
+    upload_parser = subparsers.add_parser("upload", help="Upload a local reference image.")
+    upload_parser.add_argument("image_path", type=Path)
+
+    subparsers.add_parser("animation-create", help="Create an animation job.")
+    subparsers.add_parser("animation-create-wait", help="Create an animation job and wait for completion.")
+    subparsers.add_parser("animation-create-and-wait", help="Create an animation job and wait in one call.")
+
+    animation_wait_parser = subparsers.add_parser("animation-wait", help="Fetch and wait for an animation.")
+    animation_wait_parser.add_argument("animation_id")
+
+    return parser.parse_args()
+
+
+def main() -> None:
+    args = parse_args()
+    client = make_client()
+    command = args.command or "quickstart"
+
+    if command == "quickstart":
+        quick_start(client)
+    elif command == "comic-create":
+        create_comic(client)
+    elif command == "comic-create-advanced":
+        create_comic_with_advanced_options(client)
+    elif command == "comic-get":
+        get_comic(client, args.comic_id)
+    elif command == "comic-wait":
+        wait_for_comic(client, args.comic_id)
+    elif command == "comic-create-and-wait":
+        create_and_wait_for_comic(client)
+    elif command == "comic-continue":
+        continue_comic(client, args.comic_id)
+    elif command == "comic-update-panel":
+        update_comic_panel(client, args.comic_id)
+    elif command == "usage":
+        show_usage(client)
+    elif command == "upload":
+        upload_reference_image(client, args.image_path)
+    elif command == "animation-create":
+        create_animation(client)
+    elif command == "animation-create-wait":
+        create_and_wait_for_animation_with_manual_wait(client)
+    elif command == "animation-wait":
+        wait_for_animation(client, args.animation_id)
+    elif command == "animation-create-and-wait":
+        create_and_wait_for_animation(client)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except LlamaGenAPIError as error:
+        print("LlamaGen API error:", error)
+    except LlamaGenConnectionError as error:
+        print("LlamaGen connection error:", error)
+    except LlamaGenTimeoutError as error:
+        print("LlamaGen timeout:", error)

{llamagen_python-0.1.7 → llamagen_python-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "llamagen-python"
-version = "0.1.7"
+version = "0.1.8"
 description = "Official Python SDK for LlamaGen Comic API and Animation API"
 readme = "README.md"
 requires-python = ">=3.9"

{llamagen_python-0.1.7 → llamagen_python-0.1.8}/src/llamagen/__init__.py

@@ -14,4 +14,4 @@ __all__ = [
     "SUPPORTED_COMIC_SIZES",
 ]
 
-__version__ = "0.1.7"
+__version__ = "0.1.8"

{llamagen_python-0.1.7 → llamagen_python-0.1.8}/src/llamagen/_http.py

@@ -10,7 +10,7 @@ from typing import Any, Dict, Mapping, Optional, Protocol, Tuple
 
 from ._errors import LlamaGenAPIError, LlamaGenConnectionError, LlamaGenTimeoutError
 
-DEFAULT_USER_AGENT = "llamagen-python/0.1.7"
+DEFAULT_USER_AGENT = "llamagen-python/0.1.8"
 
 
 class Transport(Protocol):

{llamagen_python-0.1.7 → llamagen_python-0.1.8}/tests/test_client.py

@@ -80,7 +80,7 @@ class ClientTests(unittest.TestCase):
         self.assertEqual(call["url"], "https://api.llamagen.ai/v1/comics/generations")
         self.assertEqual(call["headers"]["Authorization"], "Bearer test-key")
         self.assertEqual(call["headers"]["Accept"], "application/json")
-        self.assertEqual(call["headers"]["User-Agent"], "llamagen-python/0.1.7")
+        self.assertEqual(call["headers"]["User-Agent"], "llamagen-python/0.1.8")
         body = json.loads(call["body"].decode("utf-8"))
         self.assertEqual(body["preset"], "neutral")
         self.assertEqual(body["size"], "1024x1024")

llamagen_python-0.1.7/examples/Untitled.ipynb

@@ -1,84 +0,0 @@
-{
- "cells": [
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "cdc9de5a-8720-4448-abc3-f4a1a5c8f988",
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "comic.create: cmrf1zulc000rl204y6b0w4kg LOADING\n"
-     ]
-    }
-   ],
-   "source": [
-    "import os\n",
-    "from pathlib import Path\n",
-    "\n",
-    "from llamagen import LlamaGenClient\n",
-    "\n",
-    "WAIT_TIMEOUT_MS = 30 * 60 * 1000\n",
-    "\n",
-    "client = LlamaGenClient(\n",
-    "    api_key=\"sk-5d609cd64379d048edcb04dcc109a6cfaf7c066f12138c13c8c404766ab9629d\",\n",
-    "    timeout_ms=30000,\n",
-    "    max_retries=5,\n",
-    "    retry_delay_ms=500,\n",
-    ")\n",
-    "\n",
-    "created = client.comic.create({\n",
-    "    \"prompt\": \"The Little Prince meets the Fox in a luminous desert.\",\n",
-    "    \"style\": \"storybook manga\",\n",
-    "    \"size\": \"1024x1024\",\n",
-    "    \"pagination\": {\"totalPages\": 2, \"panelsPerPage\": 4},\n",
-    "    \"comicRoles\": [\n",
-    "        {\n",
-    "            \"name\": \"The Little Prince\",\n",
-    "            \"image\": \"https://example.com/prince.png\",\n",
-    "            \"clothing\": \"green coat and yellow scarf\",\n",
-    "        }\n",
-    "    ],\n",
-    "    \"attachments\": [{\"type\": \"image\", \"url\": \"https://example.com/reference.png\"}],\n",
-    "    \"language\": \"en\",\n",
-    "    \"upscale\": \"2K\",\n",
-    "})\n",
-    "print(\"comic.create:\", created[\"id\"], created.get(\"status\"))\n",
-    "\n",
-    "done = client.comic.wait_for_completion(created[\"id\"], timeout_ms=WAIT_TIMEOUT_MS)\n",
-    "print(\"comic.wait_for_completion:\", done[\"id\"], done.get(\"status\"), done.get(\"comics\"))"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "9be79812-b6f6-443e-9916-c9130dc0526b",
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.12.7"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 5
-}

llamagen_python-0.1.7/examples/quickstart.py

@@ -1,171 +0,0 @@
-import os
-from pathlib import Path
-
-from llamagen import (
-    LlamaGenAPIError,
-    LlamaGenClient,
-    LlamaGenConnectionError,
-    LlamaGenTimeoutError,
-)
-
-
-ROOT = Path(__file__).resolve().parents[1]
-WAIT_TIMEOUT_MS = 30 * 60 * 1000
-
-
-def load_dotenv(path: Path) -> None:
-    if not path.exists():
-        return
-
-    for raw_line in path.read_text(encoding="utf-8").splitlines():
-        line = raw_line.strip()
-        if not line or line.startswith("#") or "=" not in line:
-            continue
-        key, value = line.split("=", 1)
-        os.environ.setdefault(key.strip(), value.strip().strip('"').strip("'"))
-
-
-def make_client() -> LlamaGenClient:
-    load_dotenv(ROOT / ".env")
-    return LlamaGenClient(
-        api_key=os.environ["LLAMAGEN_API_KEY"],
-        timeout_ms=30000,
-        max_retries=5,
-        retry_delay_ms=500,
-    )
-
-
-def demo_comic_create_get_wait(client: LlamaGenClient) -> str:
-    created = client.comic.create(
-        {
-            "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
-            "style": "manga",
-            "fixPanelNum": 4,
-        }
-    )
-    print("comic.create:", created["id"], created.get("status"))
-
-    fetched = client.comic.get(created["id"])
-    print("comic.get:", fetched["id"], fetched.get("status"))
-
-    panel = client.comic.get(created["id"], page=0, panel=0)
-    print("comic.get panel:", panel.get("id", created["id"]), panel.get("status"))
-
-    done = client.comic.wait_for_completion(created["id"], timeout_ms=WAIT_TIMEOUT_MS)
-    print("comic.wait_for_completion:", done["id"], done.get("status"), done.get("comics"))
-    return created["id"]
-
-
-def demo_comic_usage(client: LlamaGenClient) -> None:
-    usage = client.comic.usage()
-    print("comic.usage:", usage)
-
-
-def demo_comic_upload(client: LlamaGenClient, image_path: Path) -> str:
-    uploaded = client.comic.upload(image_path)
-    print("comic.upload:", uploaded)
-    return str(uploaded.get("url") or uploaded.get("fileUrl") or uploaded.get("id") or "")
-
-
-def demo_comic_continue_write(client: LlamaGenClient, comic_id: str) -> str:
-    continued = client.comic.continue_write(
-        comic_id,
-        {
-            "prompt": "Continue the story with Leo opening a secret reading room.",
-            "pagination": {"totalPages": 1, "panelsPerPage": 4},
-        },
-    )
-    print("comic.continue_write:", continued["id"], continued.get("status"))
-    return continued["id"]
-
-
-def demo_comic_update_panel(client: LlamaGenClient, comic_id: str) -> str:
-    updated = client.comic.update_panel(
-        comic_id,
-        {
-            "panelIndex": 0,
-            "prompt": "Make the glowing key brighter and add dramatic moonlight.",
-        },
-    )
-    print("comic.update_panel:", updated["id"], updated.get("status"))
-    return updated["id"]
-
-
-def demo_comic_create_and_wait(client: LlamaGenClient) -> str:
-    done = client.comic.create_and_wait(
-        {
-            "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
-            "style": "storybook",
-            "fixPanelNum": 3,
-        },
-        timeout_ms=WAIT_TIMEOUT_MS,
-    )
-    print("comic.create_and_wait:", done["id"], done.get("status"))
-    return done["id"]
-
-
-def demo_animation_create_get_wait(client: LlamaGenClient) -> str:
-    created = client.animation.create(
-        {
-            "prompt": "A heroic fox detective walks through neon rain, cinematic camera move.",
-            "videoOptions": {
-                "duration": 5,
-                "resolution": "720p",
-                "aspect_ratio": "16:9",
-            },
-        }
-    )
-    print("animation.create:", created["id"], created.get("status"))
-
-    fetched = client.animation.get(created["id"])
-    print("animation.get:", fetched["id"], fetched.get("status"))
-
-    done = client.animation.wait_for_completion(created["id"], timeout_ms=WAIT_TIMEOUT_MS)
-    print("animation.wait_for_completion:", done["id"], done.get("status"))
-    return created["id"]
-
-
-def demo_animation_create_and_wait(client: LlamaGenClient) -> str:
-    done = client.animation.create_and_wait(
-        {
-            "prompt": "A paper boat sailing across a watercolor city at sunrise.",
-            "videoOptions": {
-                "duration": 5,
-                "resolution": "720p",
-                "aspect_ratio": "16:9",
-            },
-        },
-        timeout_ms=WAIT_TIMEOUT_MS,
-    )
-    print("animation.create_and_wait:", done["id"], done.get("status"))
-    return done["id"]
-
-
-def main() -> None:
-    client = make_client()
-
-    comic_id = demo_comic_create_get_wait(client)
-    demo_comic_usage(client)
-
-    upload_file = os.environ.get("LLAMAGEN_UPLOAD_FILE")
-    if upload_file:
-        demo_comic_upload(client, Path(upload_file))
-
-    if os.environ.get("LLAMAGEN_RUN_OPTIONAL_DEMOS") == "1":
-        demo_comic_continue_write(client, comic_id)
-        demo_comic_update_panel(client, comic_id)
-        demo_comic_create_and_wait(client)
-
-        demo_animation_create_get_wait(client)
-        demo_animation_create_and_wait(client)
-
-
-if __name__ == "__main__":
-    try:
-        main()
-    except LlamaGenAPIError as error:
-        print("LlamaGen API error:", error)
-    except LlamaGenConnectionError as error:
-        print("LlamaGen connection error:", error)
-    except LlamaGenTimeoutError as error:
-        print("LlamaGen timeout:", error)