runapi-seedream 0.2.2__tar.gz → 0.2.3__tar.gz

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/PKG-INFO

@@ -1,18 +1,18 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: runapi-seedream
-Version: 0.2.2
+Version: 0.2.3
 Summary: RunAPI Seedream SDK for text-to-image and edit-image workflows in JavaScript, Python, Ruby, Go, Java, and PHP
 Project-URL: Homepage, https://runapi.ai/models/seedream
 Project-URL: Documentation, https://runapi.ai/docs/resources/sdks
 Project-URL: Source, https://github.com/runapi-ai/seedream-sdk
 Project-URL: Issues, https://github.com/runapi-ai/seedream-sdk/issues
 Project-URL: Changelog, https://github.com/runapi-ai/seedream-sdk/blob/main/CHANGELOG.md
-Project-URL: Release Notes, https://github.com/runapi-ai/seedream-sdk/releases/tag/python%2Fv0.2.2
+Project-URL: Release Notes, https://github.com/runapi-ai/seedream-sdk/releases/tag/python%2Fv0.2.3
 Author-email: RunAPI <contact@runapi.ai>
 License-Expression: Apache-2.0
 Keywords: api,golang,gradle,image-api,image-generation,java,maven,python,ruby,runapi,runapi-ai,sdk,seedream,seedream-api,text-to-image,typescript
 Requires-Python: >=3.9
-Requires-Dist: runapi-core>=0.5.0
+Requires-Dist: runapi-core>=0.5.1
 Description-Content-Type: text/markdown
 
 # Seedream Python SDK for RunAPI
@@ -74,11 +74,11 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## Seedream 5 Pro
 
-Use `seedream-5-pro-text-to-image` for generation and `seedream-5-pro-edit` for image editing. Both accept `output_quality`, optional `output_format`, and optional content safety checking; editing accepts up to 10 source image URLs.
+Use `seedream-5-pro-text-to-image` for generation, `seedream-5-pro-edit` for image editing, and `seedream-5-pro-layer-decomposition` to separate one image into a base image and ordered transparent layers.
 
 ## Language notes
 
-Pass parameters as keyword arguments and catch the `runapi.seedream` error classes when building image jobs or scripts. The available resources are `text_to_image` and `edit_image`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+Pass parameters as keyword arguments and catch the `runapi.seedream` error classes when building image jobs or scripts. The available resources are `text_to_image`, `edit_image`, and `decompose_layers`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/README.md

@@ -57,11 +57,11 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## Seedream 5 Pro
 
-Use `seedream-5-pro-text-to-image` for generation and `seedream-5-pro-edit` for image editing. Both accept `output_quality`, optional `output_format`, and optional content safety checking; editing accepts up to 10 source image URLs.
+Use `seedream-5-pro-text-to-image` for generation, `seedream-5-pro-edit` for image editing, and `seedream-5-pro-layer-decomposition` to separate one image into a base image and ordered transparent layers.
 
 ## Language notes
 
-Pass parameters as keyword arguments and catch the `runapi.seedream` error classes when building image jobs or scripts. The available resources are `text_to_image` and `edit_image`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+Pass parameters as keyword arguments and catch the `runapi.seedream` error classes when building image jobs or scripts. The available resources are `text_to_image`, `edit_image`, and `decompose_layers`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runapi-seedream"
-version = "0.2.2"
+version = "0.2.3"
 description = "RunAPI Seedream SDK for text-to-image and edit-image workflows in JavaScript, Python, Ruby, Go, Java, and PHP"
 readme = "README.md"
 requires-python = ">=3.9"
 license = "Apache-2.0"
 authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
 keywords = ["runapi", "runapi-ai", "seedream", "api", "sdk", "typescript", "python", "ruby", "golang", "java", "maven", "gradle", "image-generation", "text-to-image", "image-api", "seedream-api"]
-dependencies = ["runapi-core>=0.5.0"]
+dependencies = ["runapi-core>=0.5.1"]
 
 [project.urls]
 Homepage = "https://runapi.ai/models/seedream"
@@ -19,7 +19,7 @@ Documentation = "https://runapi.ai/docs/resources/sdks"
 Source = "https://github.com/runapi-ai/seedream-sdk"
 Issues = "https://github.com/runapi-ai/seedream-sdk/issues"
 Changelog = "https://github.com/runapi-ai/seedream-sdk/blob/main/CHANGELOG.md"
-"Release Notes" = "https://github.com/runapi-ai/seedream-sdk/releases/tag/python%2Fv0.2.2"
+"Release Notes" = "https://github.com/runapi-ai/seedream-sdk/releases/tag/python%2Fv0.2.3"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/runapi"]

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/src/runapi/seedream/client.py

@@ -7,6 +7,7 @@ from typing import Any, Optional
 from runapi.core import ProviderClient
 
 from .resources.edit_image import EditImage
+from .resources.decompose_layers import DecomposeLayers
 from .resources.text_to_image import TextToImage
 
 
@@ -26,3 +27,4 @@ class SeedreamClient(ProviderClient):
         http = self._http
         self.text_to_image = TextToImage(http)
         self.edit_image = EditImage(http)
+        self.decompose_layers = DecomposeLayers(http)

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/src/runapi/seedream/contract_gen.py

@@ -1,4 +1,24 @@
 CONTRACT = {
+    "decompose-layers": {
+        "models": ["seedream-5-pro-layer-decomposition"],
+        "fields_by_model": {
+            "seedream-5-pro-layer-decomposition": {
+                "image_url": {
+                    "required": True
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "prompt": {
+                    "max": 5000,
+                    "length": True
+                },
+                "size": {
+                    "enum": ["auto", "1K", "1.5K", "2K"]
+                }
+            }
+        }
+    },
     "edit-image": {
         "models": ["seedream-4.5-edit", "seedream-5-lite-edit", "seedream-5-pro-edit", "seedream-v4-edit"],
         "fields_by_model": {

runapi_seedream-0.2.3/src/runapi/seedream/resources/__init__.py

@@ -0,0 +1,5 @@
+from .edit_image import EditImage
+from .decompose_layers import DecomposeLayers
+from .text_to_image import TextToImage
+
+__all__ = ["TextToImage", "EditImage", "DecomposeLayers"]

runapi_seedream-0.2.3/src/runapi/seedream/resources/decompose_layers.py

@@ -0,0 +1,30 @@
+"""Seedream layer decomposition resource."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import RequestOptions, Resource
+
+from ..contract_gen import CONTRACT
+from ..types import CompletedDecomposeLayersResponse, DecomposeLayersResponse
+
+
+class DecomposeLayers(Resource):
+    """Separate one image into a base image and independent layers."""
+
+    ENDPOINT = "/api/v1/seedream/decompose_layers"
+    RESPONSE_CLASS = DecomposeLayersResponse
+    COMPLETED_RESPONSE_CLASS = CompletedDecomposeLayersResponse
+
+    def run(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        task = self.create(options=options, **params)
+        return self._poll_until_complete(lambda: self.get(task.id, options=options))
+
+    def create(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["decompose-layers"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted, options=options)
+
+    def get(self, id: str, options: Optional[RequestOptions] = None) -> Any:
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/src/runapi/seedream/types.py

@@ -37,3 +37,20 @@ class CompletedTextToImageResponse(TextToImageResponse):
 
 
 CompletedEditImageResponse = CompletedTextToImageResponse
+
+
+class DecomposeLayersResponse(TaskResponse):
+    """Seedream layer decomposition task status response."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    base_image = optional(lambda: Image)
+    layers = optional([lambda: Image])
+    error = optional(str)
+
+
+class CompletedDecomposeLayersResponse(DecomposeLayersResponse):
+    """Narrowed response once layer decomposition completes."""
+
+    base_image = required(lambda: Image)
+    layers = required([lambda: Image])

{runapi_seedream-0.2.2 → runapi_seedream-0.2.3}/tests/test_client.py

@@ -4,8 +4,9 @@ from runapi.core import config
 from runapi.core.errors import AuthenticationError, ValidationError
 from runapi.seedream import SeedreamClient
 from runapi.seedream.resources.edit_image import EditImage
+from runapi.seedream.resources.decompose_layers import DecomposeLayers
 from runapi.seedream.resources.text_to_image import TextToImage
-from runapi.seedream.types import CompletedTextToImageResponse, TextToImageResponse
+from runapi.seedream.types import DecomposeLayersResponse, CompletedTextToImageResponse, TextToImageResponse
 
 
 class FakeHttp:
@@ -57,12 +58,45 @@ def test_uses_injected_http_client():
     client = SeedreamClient(api_key="k", http_client=fake)
     assert client.text_to_image._http is fake
     assert client.edit_image._http is fake
+    assert client.decompose_layers._http is fake
 
 
 def test_exposes_resource_accessors():
     client = SeedreamClient(api_key="k", http_client=FakeHttp())
     assert isinstance(client.text_to_image, TextToImage)
     assert isinstance(client.edit_image, EditImage)
+    assert isinstance(client.decompose_layers, DecomposeLayers)
+
+
+def test_decompose_layers_create_get_and_completed_response():
+    fake = FakeHttp(
+        {"id": "layers-1", "status": "processing"},
+        {
+            "id": "layers-1",
+            "status": "completed",
+            "base_image": {"url": "https://file.runapi.ai/base.jpeg"},
+            "layers": [{"url": "https://file.runapi.ai/layer.png"}],
+        },
+    )
+    client = SeedreamClient(api_key="k", http_client=fake)
+    created = client.decompose_layers.create(
+        model="seedream-5-pro-layer-decomposition",
+        image_url="https://cdn.runapi.ai/public/samples/image.jpg",
+        output_format="jpeg",
+    )
+    result = client.decompose_layers.get(created.id)
+
+    assert fake.calls[0] == (
+        "post",
+        "/api/v1/seedream/decompose_layers",
+        {
+            "model": "seedream-5-pro-layer-decomposition",
+            "image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
+            "output_format": "jpeg",
+        },
+    )
+    assert isinstance(result, DecomposeLayersResponse)
+    assert result.base_image.url == "https://file.runapi.ai/base.jpeg"
 
 
 # --- request shapes -------------------------------------------------------

runapi_seedream-0.2.2/src/runapi/seedream/resources/__init__.py

@@ -1,4 +0,0 @@
-from .edit_image import EditImage
-from .text_to_image import TextToImage
-
-__all__ = ["TextToImage", "EditImage"]