llamagen-python 0.1.11__tar.gz → 0.1.13__tar.gz

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llamagen-python
-Version: 0.1.11
+Version: 0.1.13
 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
@@ -71,7 +71,7 @@ client = LlamaGenClient(
 )
 
 created = client.comic.create({
-    "prompt": "Manga style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
     "preset": "japanese_manga",
     "fixPanelNum": 4,
 })
@@ -118,18 +118,23 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 generation = client.comic.create({
-    "prompt": "Anime storybook style, The Little Prince meets the Fox in a luminous desert.",
+    "prompt": "The Little Prince meets the Fox in a luminous desert.",
     "preset": "animeStyle",
     "size": "1024x1024",
     "pagination": {"totalPages": 2, "panelsPerPage": 4},
     "comicRoles": [
         {
             "name": "The Little Prince",
-            "image": "https://example.com/prince.png",
+            "image": "https://s.llamagen.ai/public/61965b97-23fe-4405-853d-efe17b5d6f08-prince.webp",
             "dress": "green coat and yellow scarf",
         }
     ],
-    "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
+    "attachments": [
+        {
+            "type": "image",
+            "url": "https://s.llamagen.ai/public/7eeaad2c-fd6b-4679-90ce-884503f011b7-reference.webp",
+        }
+    ],
     "language": "en",
     "upscale": "2K",
 })
@@ -137,7 +142,7 @@ generation = client.comic.create({
 
 Comic methods:
 
-- `llamagen.comic.create(params)` submits a new comic generation job and returns the created job id, status, and usage metadata. Use `preset` for a known style preset id, or describe the visual style in `prompt`.
+- `llamagen.comic.create(params)` submits a new comic generation job and returns the created job id, status, and usage metadata. Use `preset` for a known style preset id; keep `prompt` focused on story, characters, scene, and action.
 - `llamagen.comic.get(id, page=None, panel=None)` fetches a comic generation's status and result, or a specific page or panel.
 - `llamagen.comic.continue_write(id, params)` extends an existing comic.
 - `llamagen.comic.update_panel(id, params)` regenerates one panel.
@@ -158,7 +163,7 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 created = client.comic.create({
-    "prompt": "Bold comic style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
     "preset": "comicBookStyle",
     "fixPanelNum": 4,
 })
@@ -210,8 +215,8 @@ WAIT_TIMEOUT_MS = 30 * 60 * 1000
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 finished = client.comic.create_and_wait({
-    "prompt": "Retro American comic style, a cozy 3-panel comic about a robot learning to bake bread.",
-    "preset": "american_comic_90",
+    "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
+    "preset": "comicBookStyle",
     "fixPanelNum": 3,
 }, timeout_ms=WAIT_TIMEOUT_MS)
 print("comic.create_and_wait:", finished["id"], finished.get("status"))

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/README.md

@@ -46,7 +46,7 @@ client = LlamaGenClient(
 )
 
 created = client.comic.create({
-    "prompt": "Manga style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
     "preset": "japanese_manga",
     "fixPanelNum": 4,
 })
@@ -93,18 +93,23 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 generation = client.comic.create({
-    "prompt": "Anime storybook style, The Little Prince meets the Fox in a luminous desert.",
+    "prompt": "The Little Prince meets the Fox in a luminous desert.",
     "preset": "animeStyle",
     "size": "1024x1024",
     "pagination": {"totalPages": 2, "panelsPerPage": 4},
     "comicRoles": [
         {
             "name": "The Little Prince",
-            "image": "https://example.com/prince.png",
+            "image": "https://s.llamagen.ai/public/61965b97-23fe-4405-853d-efe17b5d6f08-prince.webp",
             "dress": "green coat and yellow scarf",
         }
     ],
-    "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
+    "attachments": [
+        {
+            "type": "image",
+            "url": "https://s.llamagen.ai/public/7eeaad2c-fd6b-4679-90ce-884503f011b7-reference.webp",
+        }
+    ],
     "language": "en",
     "upscale": "2K",
 })
@@ -112,7 +117,7 @@ generation = client.comic.create({
 
 Comic methods:
 
-- `llamagen.comic.create(params)` submits a new comic generation job and returns the created job id, status, and usage metadata. Use `preset` for a known style preset id, or describe the visual style in `prompt`.
+- `llamagen.comic.create(params)` submits a new comic generation job and returns the created job id, status, and usage metadata. Use `preset` for a known style preset id; keep `prompt` focused on story, characters, scene, and action.
 - `llamagen.comic.get(id, page=None, panel=None)` fetches a comic generation's status and result, or a specific page or panel.
 - `llamagen.comic.continue_write(id, params)` extends an existing comic.
 - `llamagen.comic.update_panel(id, params)` regenerates one panel.
@@ -133,7 +138,7 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 created = client.comic.create({
-    "prompt": "Bold comic style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
     "preset": "comicBookStyle",
     "fixPanelNum": 4,
 })
@@ -185,8 +190,8 @@ WAIT_TIMEOUT_MS = 30 * 60 * 1000
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 finished = client.comic.create_and_wait({
-    "prompt": "Retro American comic style, a cozy 3-panel comic about a robot learning to bake bread.",
-    "preset": "american_comic_90",
+    "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
+    "preset": "comicBookStyle",
     "fixPanelNum": 3,
 }, timeout_ms=WAIT_TIMEOUT_MS)
 print("comic.create_and_wait:", finished["id"], finished.get("status"))

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/examples/Untitled.ipynb

@@ -42,34 +42,51 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "f0c6df20-22f8-410e-9920-691f2d9b6557",
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "comic.create: cmrfstpbx0003l604n4njl7e3 LOADING\n",
+      "comic.wait_for_completion: cmrfstpbx0003l604n4njl7e3 PROCESSED [{'page': 0, 'prompt': 'A 4-panel comic about Leo finding a glowing key in a quiet library.', 'beginPageIndex': 0, 'totalPages': 1, 'panelsPerPage': 4, 'layout': 'Layout0', 'panels': [{'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/bfa3c3a1-9ab7-491a-9937-c1682332cea4.png', 'panel': 0, 'caption': \"It's so peaceful here... So many books I've never read.\", 'image': []}, {'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/9074f3ac-b3b4-4dd5-b908-5a203065e5b4.png', 'panel': 1, 'caption': 'What is that light...?', 'image': []}, {'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/a5b6902d-bb04-4519-9f95-f99926bcb260.png', 'panel': 2, 'caption': \"Is this someone's lost key? It's so bright...\", 'image': []}, {'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/30c758d6-209f-46f4-8f0d-84ca156151c3.png', 'panel': 3, 'caption': 'What secrets do you hold?', 'image': []}], 'update': 1783740192609, 'firstUpdate': 1783740192609}]\n"
+     ]
+    }
+   ],
    "source": [
     "import os\n",
     "\n",
     "from llamagen import LlamaGenClient\n",
     "\n",
-    "client = LlamaGenClient(api_key=\"sk-5d609cd64379d048edcb04dcc109a6cfaf7c066f12138c13c8c404766ab9629d\")\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\": \"A 4-panel comic about Leo finding a glowing key in a quiet library.\",\n",
+    "    \"preset\": \"japanese_manga\",\n",
+    "    \"fixPanelNum\": 4,\n",
+    "})\n",
+    "print(\"comic.create:\", created[\"id\"], created.get(\"status\"))\n",
     "\n",
-    "generation = 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",
-    "})"
+    "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": "77cc80bf-967e-4da5-bf9e-d8858914f2a4",
+   "metadata": {},
+   "outputs": [],
+   "source": []
   }
  ],
  "metadata": {

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/examples/quickstart.py

@@ -39,7 +39,7 @@ def make_client() -> LlamaGenClient:
 def quick_start(client: LlamaGenClient) -> None:
     created = client.comic.create(
         {
-            "prompt": "Manga style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+            "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
             "preset": "japanese_manga",
             "fixPanelNum": 4,
         }
@@ -53,7 +53,7 @@ def quick_start(client: LlamaGenClient) -> None:
 def create_comic(client: LlamaGenClient) -> None:
     created = client.comic.create(
         {
-            "prompt": "Bold comic style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+            "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
             "preset": "comicBookStyle",
             "fixPanelNum": 4,
         }
@@ -64,18 +64,23 @@ def create_comic(client: LlamaGenClient) -> None:
 def create_comic_with_advanced_options(client: LlamaGenClient) -> None:
     generation = client.comic.create(
         {
-            "prompt": "Anime storybook style, The Little Prince meets the Fox in a luminous desert.",
+            "prompt": "The Little Prince meets the Fox in a luminous desert.",
             "preset": "animeStyle",
             "size": "1024x1024",
             "pagination": {"totalPages": 2, "panelsPerPage": 4},
             "comicRoles": [
                 {
                     "name": "The Little Prince",
-                    "image": "https://example.com/prince.png",
+                    "image": "https://s.llamagen.ai/public/61965b97-23fe-4405-853d-efe17b5d6f08-prince.webp",
                     "dress": "green coat and yellow scarf",
                 }
             ],
-            "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
+            "attachments": [
+                {
+                    "type": "image",
+                    "url": "https://s.llamagen.ai/public/7eeaad2c-fd6b-4679-90ce-884503f011b7-reference.webp",
+                }
+            ],
             "language": "en",
             "upscale": "2K",
         }
@@ -99,8 +104,8 @@ def wait_for_comic(client: LlamaGenClient, comic_id: str) -> None:
 def create_and_wait_for_comic(client: LlamaGenClient) -> None:
     finished = client.comic.create_and_wait(
         {
-            "prompt": "Retro American comic style, a cozy 3-panel comic about a robot learning to bake bread.",
-            "preset": "american_comic_90",
+            "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
+            "preset": "comicBookStyle",
             "fixPanelNum": 3,
         },
         timeout_ms=WAIT_TIMEOUT_MS,

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/pyproject.toml

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

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/src/llamagen/__init__.py

@@ -14,4 +14,4 @@ __all__ = [
     "SUPPORTED_COMIC_SIZES",
 ]
 
-__version__ = "0.1.11"
+__version__ = "0.1.13"

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/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.11"
+DEFAULT_USER_AGENT = "llamagen-python/0.1.13"
 
 
 class Transport(Protocol):

{llamagen_python-0.1.11 → llamagen_python-0.1.13}/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.11")
+        self.assertEqual(call["headers"]["User-Agent"], "llamagen-python/0.1.13")
         body = json.loads(call["body"].decode("utf-8"))
         self.assertEqual(body["preset"], "neutral")
         self.assertEqual(body["size"], "1024x1024")