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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llamagen-python
-Version: 0.1.8
+Version: 0.1.10
 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
@@ -81,26 +81,10 @@ 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`.
-
-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.
+All Python examples below are self-contained for copy/paste usage in your own
+script, notebook, worker, or backend service. 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
 
@@ -153,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.
+- `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.
@@ -332,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.8 → llamagen_python-0.1.10}/README.md

@@ -56,26 +56,10 @@ 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`.
-
-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.
+All Python examples below are self-contained for copy/paste usage in your own
+script, notebook, worker, or backend service. 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
 
@@ -128,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.
+- `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.
@@ -307,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.8 → llamagen_python-0.1.10}/pyproject.toml

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

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

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

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

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