llamagen-python 0.1.12__tar.gz → 0.1.14__tar.gz

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llamagen-python
-Version: 0.1.12
+Version: 0.1.14
 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
@@ -66,8 +66,6 @@ WAIT_TIMEOUT_MS = 30 * 60 * 1000
 client = LlamaGenClient(
     api_key=os.environ["LLAMAGEN_API_KEY"],
     timeout_ms=30000,
-    max_retries=5,
-    retry_delay_ms=500,
 )
 
 created = client.comic.create({
@@ -95,13 +93,13 @@ client = LlamaGenClient(
     api_key="YOUR_API_KEY",
     base_url="https://api.llamagen.ai/v1",
     timeout_ms=30000,
-    max_retries=5,
-    retry_delay_ms=500,
 )
 ```
 
 The SDK uses Python's standard library HTTP stack and does not require runtime
-dependencies.
+dependencies. The legacy `max_retries` and `retry_delay_ms` options remain
+accepted for compatibility, but automatic HTTP retries are disabled to avoid
+duplicating billable generation requests.
 
 ## Comic API
 
@@ -125,11 +123,16 @@ generation = client.comic.create({
     "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",
 })
@@ -415,5 +418,5 @@ except LlamaGenTimeoutError as error:
 ```
 
 - `LlamaGenAPIError`: the API returned a non-2xx response, such as `401`, `403`, or `429`.
-- `LlamaGenConnectionError`: the SDK could not connect to the API after retries.
-- `LlamaGenTimeoutError`: the request timed out after retries.
+- `LlamaGenConnectionError`: the SDK could not connect to the API.
+- `LlamaGenTimeoutError`: the request timed out.

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/README.md

@@ -41,8 +41,6 @@ WAIT_TIMEOUT_MS = 30 * 60 * 1000
 client = LlamaGenClient(
     api_key=os.environ["LLAMAGEN_API_KEY"],
     timeout_ms=30000,
-    max_retries=5,
-    retry_delay_ms=500,
 )
 
 created = client.comic.create({
@@ -70,13 +68,13 @@ client = LlamaGenClient(
     api_key="YOUR_API_KEY",
     base_url="https://api.llamagen.ai/v1",
     timeout_ms=30000,
-    max_retries=5,
-    retry_delay_ms=500,
 )
 ```
 
 The SDK uses Python's standard library HTTP stack and does not require runtime
-dependencies.
+dependencies. The legacy `max_retries` and `retry_delay_ms` options remain
+accepted for compatibility, but automatic HTTP retries are disabled to avoid
+duplicating billable generation requests.
 
 ## Comic API
 
@@ -100,11 +98,16 @@ generation = client.comic.create({
     "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",
 })
@@ -390,5 +393,5 @@ except LlamaGenTimeoutError as error:
 ```
 
 - `LlamaGenAPIError`: the API returned a non-2xx response, such as `401`, `403`, or `429`.
-- `LlamaGenConnectionError`: the SDK could not connect to the API after retries.
-- `LlamaGenTimeoutError`: the request timed out after retries.
+- `LlamaGenConnectionError`: the SDK could not connect to the API.
+- `LlamaGenTimeoutError`: the request timed out.

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/examples/quickstart.py

@@ -71,11 +71,16 @@ def create_comic_with_advanced_options(client: LlamaGenClient) -> None:
             "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",
         }

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/pyproject.toml

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

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/src/llamagen/__init__.py

@@ -14,4 +14,4 @@ __all__ = [
     "SUPPORTED_COMIC_SIZES",
 ]
 
-__version__ = "0.1.12"
+__version__ = "0.1.14"

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/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.12"
+DEFAULT_USER_AGENT = "llamagen-python/0.1.14"
 
 
 class Transport(Protocol):
@@ -60,8 +60,10 @@ class HTTPClient:
         self.api_key = api_key
         self.base_url = base_url.rstrip("/")
         self.timeout = timeout_ms / 1000
-        self.max_retries = max_retries
-        self.retry_delay = retry_delay_ms / 1000
+        # Kept in the public API for compatibility; automatic retries can
+        # duplicate non-idempotent, billable generation requests.
+        self.max_retries = 0
+        self.retry_delay = 60
         self.transport = transport or UrllibTransport()
 
     def request(

{llamagen_python-0.1.12 → llamagen_python-0.1.14}/tests/test_client.py

@@ -1,12 +1,13 @@
 from __future__ import annotations
 
 import json
+import socket
 import ssl
 import unittest
 import urllib.error
 from typing import Mapping, Optional, Tuple
 
-from llamagen import LlamaGenAPIError, LlamaGenClient, LlamaGenConnectionError
+from llamagen import LlamaGenAPIError, LlamaGenClient, LlamaGenConnectionError, LlamaGenTimeoutError
 from llamagen.resources.animations import DEFAULT_WAIT_TIMEOUT_MS as ANIMATION_WAIT_TIMEOUT_MS
 from llamagen.resources.comics import DEFAULT_WAIT_TIMEOUT_MS as COMIC_WAIT_TIMEOUT_MS
 
@@ -80,7 +81,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.12")
+        self.assertEqual(call["headers"]["User-Agent"], "llamagen-python/0.1.14")
         body = json.loads(call["body"].decode("utf-8"))
         self.assertEqual(body["preset"], "neutral")
         self.assertEqual(body["size"], "1024x1024")
@@ -157,20 +158,33 @@ class ClientTests(unittest.TestCase):
         body = json.loads(transport.calls[0]["body"].decode("utf-8"))
         self.assertEqual(body["action"], "regeneratePanel")
 
-    def test_retries_ssl_url_errors_and_raises_connection_error(self):
-        transport = FailingTransport(
-            [
-                urllib.error.URLError(ssl.SSLEOFError("unexpected eof")),
-                urllib.error.URLError(ssl.SSLEOFError("unexpected eof")),
-                urllib.error.URLError(ssl.SSLEOFError("unexpected eof")),
-            ]
+    def test_max_retries_is_ignored_for_connection_errors(self):
+        transport = FailingTransport([urllib.error.URLError(ssl.SSLEOFError("unexpected eof"))])
+        client = LlamaGenClient(
+            api_key="test-key",
+            max_retries=5,
+            retry_delay_ms=1,
+            transport=transport,
         )
-        client = LlamaGenClient(api_key="test-key", retry_delay_ms=1, transport=transport)
 
         with self.assertRaises(LlamaGenConnectionError):
             client.comic.usage()
 
-        self.assertEqual(len(transport.calls), 3)
+        self.assertEqual(len(transport.calls), 1)
+
+    def test_max_retries_is_ignored_for_create_timeouts(self):
+        transport = FailingTransport([socket.timeout("timed out")])
+        client = LlamaGenClient(
+            api_key="test-key",
+            max_retries=5,
+            retry_delay_ms=1,
+            transport=transport,
+        )
+
+        with self.assertRaises(LlamaGenTimeoutError):
+            client.comic.create({"prompt": "A short comic.", "fixPanelNum": 1})
+
+        self.assertEqual(len(transport.calls), 1)
 
     def test_wait_for_completion_continues_after_transient_connection_error(self):
         transport = MixedTransport(

llamagen_python-0.1.12/examples/Untitled.ipynb

@@ -1,96 +0,0 @@
-{
- "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
-}