runware-sdk 1.3.2__tar.gz → 1.4.0__tar.gz

{runware_sdk-1.3.2 → runware_sdk-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runware-sdk
-Version: 1.3.2
+Version: 1.4.0
 Summary: Async Python SDK for the Runware platform — image, video, audio, text, and 3D generation, plus upscaling, background removal, and more, over REST or WebSocket with typed parameters and runtime validation.
 Keywords: runware,ai,sdk,image-generation,video-generation,audio-generation,text-generation,inference,generative-ai,stable-diffusion,flux,websocket,async,asyncio,llm,streaming
 Author: Runware
@@ -627,6 +627,8 @@ google = await client.content.get_creator("google")
 page = await client.content.list_models({"paginate": True, "limit": 25, "offset": 0})
 ```
 
+The per-model methods (`get_model`, `get_model_examples`, `get_model_pricing`) accept either the model's AIR or its catalog slug (the `model` field returned by `list_models`).
+
 `creator`, `capabilities`, and `architecture` on each model are returned as id strings — resolve them against `list_creators`, `list_capabilities`, and the architecture id respectively when you need the human-readable label. Collections and creators are the only endpoints that resolve their inner `models` array to full objects.
 
 ## File helpers
@@ -643,6 +645,15 @@ await client.image_upload({"image": data_uri})
 
 Accepts both `Path` and `bytes` — `bytes` is useful when the file lives in memory (e.g. a freshly downloaded blob).
 
+`file_to_base64` does the same read but returns raw base64 with no `data:` prefix or MIME type (the server sniffs the real format from the bytes).
+
+You usually don't need either helper for inputs: `run()` and `image_upload` auto-encode local file paths. Any string value (recursively, including nested dicts and lists) that points to an existing file on disk is read and replaced with its base64 before the request is sent. URLs, UUIDs, data URIs, existing base64, and prompts pass through untouched.
+
+```python
+await client.run({"model": "...", "seedImage": "./photo.jpg"})
+await client.run({"model": "...", "referenceImages": ["./a.jpg", "./b.jpg"]})
+```
+
 ## Custom dependencies
 
 For testing, proxies, or custom auth flows, pass a `RuntimeDependencies`:

{runware_sdk-1.3.2 → runware_sdk-1.4.0}/README.md

@@ -590,6 +590,8 @@ google = await client.content.get_creator("google")
 page = await client.content.list_models({"paginate": True, "limit": 25, "offset": 0})
 ```
 
+The per-model methods (`get_model`, `get_model_examples`, `get_model_pricing`) accept either the model's AIR or its catalog slug (the `model` field returned by `list_models`).
+
 `creator`, `capabilities`, and `architecture` on each model are returned as id strings — resolve them against `list_creators`, `list_capabilities`, and the architecture id respectively when you need the human-readable label. Collections and creators are the only endpoints that resolve their inner `models` array to full objects.
 
 ## File helpers
@@ -606,6 +608,15 @@ await client.image_upload({"image": data_uri})
 
 Accepts both `Path` and `bytes` — `bytes` is useful when the file lives in memory (e.g. a freshly downloaded blob).
 
+`file_to_base64` does the same read but returns raw base64 with no `data:` prefix or MIME type (the server sniffs the real format from the bytes).
+
+You usually don't need either helper for inputs: `run()` and `image_upload` auto-encode local file paths. Any string value (recursively, including nested dicts and lists) that points to an existing file on disk is read and replaced with its base64 before the request is sent. URLs, UUIDs, data URIs, existing base64, and prompts pass through untouched.
+
+```python
+await client.run({"model": "...", "seedImage": "./photo.jpg"})
+await client.run({"model": "...", "referenceImages": ["./a.jpg", "./b.jpg"]})
+```
+
 ## Custom dependencies
 
 For testing, proxies, or custom auth flows, pass a `RuntimeDependencies`:

{runware_sdk-1.3.2 → runware_sdk-1.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runware-sdk"
-version = "1.3.2"
+version = "1.4.0"
 description = "Async Python SDK for the Runware platform — image, video, audio, text, and 3D generation, plus upscaling, background removal, and more, over REST or WebSocket with typed parameters and runtime validation."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -165,6 +165,13 @@ reportUnusedFunction = "none"
 root = "scripts"
 reportAny = "none"
 reportExplicitAny = "none"
+# The generator walks arbitrary JSON Schema where every node is `Any` until
+# narrowed — fully typing a recursive, dynamic schema isn't worthwhile, so the
+# honest-Any rules are off here (as in the tests env). Everything else stays
+# enforced, including discarded call results (`_ =` at each side-effect call).
+reportUnknownVariableType = "none"
+reportUnknownMemberType = "none"
+reportUnknownArgumentType = "none"
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"

{runware_sdk-1.3.2 → runware_sdk-1.4.0}/runware/__init__.py

@@ -48,6 +48,7 @@ Validation:
 
 Helpers:
     file_to_data_uri           — encode files/bytes as data URIs for inputs
+    file_to_base64             — encode files/bytes as raw base64 (no data: prefix)
 
 Schemas pin:
     SCHEMAS_VERSION            — the pinned schemas-bundle version
@@ -145,7 +146,7 @@ from .types.task_map import (
     models,
     operation_task_types,
 )
-from .utils.file import file_to_data_uri
+from .utils.file import file_to_base64, file_to_data_uri
 from .validate import clear_validator_cache
 
 __all__ = [
@@ -235,6 +236,7 @@ __all__ = [
     "create_logger",
     "create_registry",
     "create_runware_error",
+    "file_to_base64",
     "file_to_data_uri",
     "is_runware_error",
     "modality_task_types",

{runware_sdk-1.3.2 → runware_sdk-1.4.0}/runware/_schemas_version.py

@@ -9,4 +9,4 @@ Read at build time only — runtime schema validation hits the live
 ``/resolve/<model>`` endpoint and doesn't consult this constant.
 """
 
-SCHEMAS_VERSION = "20260618151239"
+SCHEMAS_VERSION = "20260623192341"

{runware_sdk-1.3.2 → runware_sdk-1.4.0}/runware/client.py

@@ -78,6 +78,7 @@ from .types.task_map import (
     operation_task_types as _bundled_operation_task_types,
 )
 from .types.transport import RequestOptions, WireFrame
+from .utils.file import encode_local_files
 from .validate import validate_tasks
 
 
@@ -253,6 +254,7 @@ class Runware:
         options: RunOptions | None = None,
     ) -> list[dict[str, Any]]:  # pyright: ignore[reportExplicitAny]
         """Run an inference task."""
+        params = cast("dict[str, Any]", encode_local_files(params))  # pyright: ignore[reportExplicitAny]
         params = await self._normalize_model_param(params)
         task_type = await self._resolve_task_type(params)
         task_uuid = str(params.get("taskUUID") or uuid.uuid4())
@@ -366,9 +368,10 @@ class Runware:
     async def image_upload(
         self, params: ImageUploadParams, options: RunOptions | None = None,
     ) -> list[ImageUploadResult]:
+        encoded = cast("dict[str, Any]", encode_local_files(dict(params)))  # pyright: ignore[reportExplicitAny]
         return cast(
             list[ImageUploadResult],
-            await self._utility("imageUpload", dict(params), options),
+            await self._utility("imageUpload", encoded, options),
         )
 
     async def account_management(