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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llamagen-python
-Version: 0.1.9
+Version: 0.1.11
 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,8 +71,8 @@ client = LlamaGenClient(
 )
 
 created = client.comic.create({
-    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
-    "style": "manga",
+    "prompt": "Manga style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "preset": "japanese_manga",
     "fixPanelNum": 4,
 })
 print("comic.create:", created["id"], created.get("status"))
@@ -118,15 +118,15 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 generation = client.comic.create({
-    "prompt": "The Little Prince meets the Fox in a luminous desert.",
-    "style": "storybook manga",
+    "prompt": "Anime storybook style, 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",
-            "clothing": "green coat and yellow scarf",
+            "dress": "green coat and yellow scarf",
         }
     ],
     "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
@@ -137,11 +137,11 @@ generation = client.comic.create({
 
 Comic methods:
 
-- `llamagen.comic.create(params)` calls `POST /v1/comics/generations`.
-- `llamagen.comic.get(id, page=None, panel=None)` calls `GET /v1/comics/generations/{id}`.
+- `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.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.
-- `llamagen.comic.usage()` calls `GET /v1/comics/usage`.
+- `llamagen.comic.usage()` fetches the current Comic API usage, available quota, and credit information for the API key.
 - `llamagen.comic.upload(file, filename=None)` calls `POST /v1/comics/upload`.
 - `llamagen.comic.wait_for_completion(id, **options)` polls until a terminal status.
 - `llamagen.comic.create_and_wait(params, **options)` creates and polls.
@@ -158,8 +158,8 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 created = client.comic.create({
-    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
-    "style": "manga",
+    "prompt": "Bold comic style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "preset": "comicBookStyle",
     "fixPanelNum": 4,
 })
 print("comic.create:", created["id"], created.get("status"))
@@ -210,8 +210,8 @@ WAIT_TIMEOUT_MS = 30 * 60 * 1000
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 finished = client.comic.create_and_wait({
-    "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
-    "style": "storybook",
+    "prompt": "Retro American comic style, a cozy 3-panel comic about a robot learning to bake bread.",
+    "preset": "american_comic_90",
     "fixPanelNum": 3,
 }, timeout_ms=WAIT_TIMEOUT_MS)
 print("comic.create_and_wait:", finished["id"], finished.get("status"))
@@ -316,8 +316,8 @@ print("animation.wait_for_completion:", finished["id"], finished.get("status"))
 
 Animation methods:
 
-- `llamagen.animation.create(params)` calls `POST /v1/artworks/generations`.
-- `llamagen.animation.get(id)` calls `GET /v1/artworks/generations/{id}`.
+- `llamagen.animation.create(params)` submits a new animation generation job and returns the created job id, status, and usage metadata.
+- `llamagen.animation.get(id)` fetches an animation generation's status, result, and output video metadata.
 - `llamagen.animation.wait_for_completion(id, **options)` polls video status.
 - `llamagen.animation.create_and_wait(params, **options)` creates and polls.
 

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

@@ -46,8 +46,8 @@ client = LlamaGenClient(
 )
 
 created = client.comic.create({
-    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
-    "style": "manga",
+    "prompt": "Manga style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "preset": "japanese_manga",
     "fixPanelNum": 4,
 })
 print("comic.create:", created["id"], created.get("status"))
@@ -93,15 +93,15 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 generation = client.comic.create({
-    "prompt": "The Little Prince meets the Fox in a luminous desert.",
-    "style": "storybook manga",
+    "prompt": "Anime storybook style, 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",
-            "clothing": "green coat and yellow scarf",
+            "dress": "green coat and yellow scarf",
         }
     ],
     "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
@@ -112,11 +112,11 @@ generation = client.comic.create({
 
 Comic methods:
 
-- `llamagen.comic.create(params)` calls `POST /v1/comics/generations`.
-- `llamagen.comic.get(id, page=None, panel=None)` calls `GET /v1/comics/generations/{id}`.
+- `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.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.
-- `llamagen.comic.usage()` calls `GET /v1/comics/usage`.
+- `llamagen.comic.usage()` fetches the current Comic API usage, available quota, and credit information for the API key.
 - `llamagen.comic.upload(file, filename=None)` calls `POST /v1/comics/upload`.
 - `llamagen.comic.wait_for_completion(id, **options)` polls until a terminal status.
 - `llamagen.comic.create_and_wait(params, **options)` creates and polls.
@@ -133,8 +133,8 @@ from llamagen import LlamaGenClient
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 created = client.comic.create({
-    "prompt": "A 4-panel comic about Leo finding a glowing key in a quiet library.",
-    "style": "manga",
+    "prompt": "Bold comic style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+    "preset": "comicBookStyle",
     "fixPanelNum": 4,
 })
 print("comic.create:", created["id"], created.get("status"))
@@ -185,8 +185,8 @@ WAIT_TIMEOUT_MS = 30 * 60 * 1000
 client = LlamaGenClient(api_key=os.environ["LLAMAGEN_API_KEY"])
 
 finished = client.comic.create_and_wait({
-    "prompt": "A cozy 3-panel comic about a robot learning to bake bread.",
-    "style": "storybook",
+    "prompt": "Retro American comic style, a cozy 3-panel comic about a robot learning to bake bread.",
+    "preset": "american_comic_90",
     "fixPanelNum": 3,
 }, timeout_ms=WAIT_TIMEOUT_MS)
 print("comic.create_and_wait:", finished["id"], finished.get("status"))
@@ -291,8 +291,8 @@ print("animation.wait_for_completion:", finished["id"], finished.get("status"))
 
 Animation methods:
 
-- `llamagen.animation.create(params)` calls `POST /v1/artworks/generations`.
-- `llamagen.animation.get(id)` calls `GET /v1/artworks/generations/{id}`.
+- `llamagen.animation.create(params)` submits a new animation generation job and returns the created job id, status, and usage metadata.
+- `llamagen.animation.get(id)` fetches an animation generation's status, result, and output video metadata.
 - `llamagen.animation.wait_for_completion(id, **options)` polls video status.
 - `llamagen.animation.create_and_wait(params, **options)` creates and polls.
 

llamagen_python-0.1.11/examples/Untitled.ipynb

@@ -0,0 +1,96 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "1a448d8d-251a-4351-a830-0372b055fb65",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "comic.create: cmrfqxwsu0003l404hr39nmhm LOADING\n",
+      "comic.wait_for_completion: cmrfqxwsu0003l404hr39nmhm 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/f521f8e4-abcd-4e1f-9e42-48f6b7a8715c.png', 'panel': 0, 'caption': 'Leo quietly browses the library shelves, lost in the peaceful atmosphere.', 'image': []}, {'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/72b6b5f4-05bb-499e-9528-0c5b418b5eba.png', 'panel': 1, 'caption': 'Leo notices a faint glow beneath one of the lower shelves.', 'image': []}, {'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/62e36e8c-0a74-4bc8-a44a-c3bbf9f880c7.png', 'panel': 2, 'caption': 'Leo carefully reaches under the shelf and retrieves the glowing key.', 'image': []}, {'assetUrl': 'https://s.llamagen.ai/clr907a8t0000jp08cgdqv78h/7ed32fee-379f-4f48-9880-1c06739ee240.png', 'panel': 3, 'caption': 'Leo gazes at the glowing key, his eyes full of wonder and imagination.', 'image': []}], 'update': 1783737031958, 'firstUpdate': 1783737031958}]\n"
+     ]
+    }
+   ],
+   "source": [
+    "import os\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\": \"A 4-panel comic about Leo finding a glowing key in a quiet library.\",\n",
+    "    \"style\": \"manga\",\n",
+    "    \"fixPanelNum\": 4,\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": "f0c6df20-22f8-410e-9920-691f2d9b6557",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "\n",
+    "from llamagen import LlamaGenClient\n",
+    "\n",
+    "client = LlamaGenClient(api_key=\"sk-5d609cd64379d048edcb04dcc109a6cfaf7c066f12138c13c8c404766ab9629d\")\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",
+    "})"
+   ]
+  }
+ ],
+ "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.9 → llamagen_python-0.1.11}/examples/quickstart.py

@@ -39,8 +39,8 @@ def make_client() -> LlamaGenClient:
 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",
+            "prompt": "Manga style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+            "preset": "japanese_manga",
             "fixPanelNum": 4,
         }
     )
@@ -53,8 +53,8 @@ def quick_start(client: LlamaGenClient) -> None:
 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",
+            "prompt": "Bold comic style, a 4-panel comic about Leo finding a glowing key in a quiet library.",
+            "preset": "comicBookStyle",
             "fixPanelNum": 4,
         }
     )
@@ -64,15 +64,15 @@ def create_comic(client: LlamaGenClient) -> None:
 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",
+            "prompt": "Anime storybook style, 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",
-                    "clothing": "green coat and yellow scarf",
+                    "dress": "green coat and yellow scarf",
                 }
             ],
             "attachments": [{"type": "image", "url": "https://example.com/reference.png"}],
@@ -99,8 +99,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": "A cozy 3-panel comic about a robot learning to bake bread.",
-            "style": "storybook",
+            "prompt": "Retro American comic style, a cozy 3-panel comic about a robot learning to bake bread.",
+            "preset": "american_comic_90",
             "fixPanelNum": 3,
         },
         timeout_ms=WAIT_TIMEOUT_MS,

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

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

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

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

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

{llamagen_python-0.1.9 → llamagen_python-0.1.11}/src/llamagen/_types.py

@@ -29,8 +29,7 @@ class ComicRole(TypedDict, total=False):
     image: str
     age: Union[int, str]
     gender: str
-    clothing: str
-    description: str
+    dress: str
 
 
 class ComicLocation(TypedDict, total=False):
@@ -49,11 +48,9 @@ class CreateComicParams(TypedDict, total=False):
     size: str
     model: str
     preset: str
-    style: str
     promptUrl: str
     fixPanelNum: int
     pagination: ComicPagination
-    images: List[str]
     comicRoles: List[ComicRole]
     comicLocations: List[ComicLocation]
     attachments: List[ComicAttachment]
@@ -66,7 +63,6 @@ class ContinueComicParams(TypedDict, total=False):
     fixPanelNum: int
     pagination: ComicPagination
     attachments: List[ComicAttachment]
-    images: List[str]
 
 
 class UpdateComicPanelParams(TypedDict, total=False):

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