runapi-seedream 0.2.11 → 0.2.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c18b722373785d38b9f50012f72d631079cb7e6969a5fcbe2478f540db2ef985
-  data.tar.gz: 8da8e9cc24e5aef92bd396a29aa52d1eb2d79d96d24ecd073fd82c534ec45f0d
+  metadata.gz: c3c87b639ed82afc9c4f7d96106fcd9ee3ebfa322cfa20219bdd6d21e3d7c44c
+  data.tar.gz: 7a478828b7c2de132e32a280f6e1c8b4056eadb34c52f4092e712179bfa86a0c
 SHA512:
-  metadata.gz: 989112c12aec51764f7c222088112d6f72847c9d0ebd75fc86a9c0c5ffebe7ebe1d7fef3727e3ad11dcb3824b55271431581f983e93ec4658162d2dc5a5a9aae
-  data.tar.gz: 95a1ce3e40e62ea60daffd99569b57daaddc9561015a910a67b67e7446d8746247e415f6d88640c9960c2252acbb82f8fe5e2d4110a2aa580039e4a187c22e3e
+  metadata.gz: 47957fba900faba71a1b000d6f4808f60b1494732883e1f14fc291933aff99ea0423943148252801694f31e24915b826295a07e5d72fc598b07f836110ca2935
+  data.tar.gz: fd41da8643a0c7d487e829210972f2773fb5b804ae807596cb16e5807c628a9e7bddbf2c33e41850d04d621433558de3fae205ad24495e57428c46b12163b827

data/README.md

@@ -32,11 +32,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
 
-Use Ruby keyword arguments and the `RunApi::Seedream` error classes when building image jobs, Rails workers, or scripts. The package exposes `text_to_image` for text models and `edit_image` for editing models. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+Use Ruby keyword arguments and the `RunApi::Seedream` error classes when building image jobs, Rails workers, or scripts. The package exposes `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
 

data/lib/runapi/seedream/client.rb

@@ -29,11 +29,14 @@ module RunApi
       attr_reader :text_to_image
       # @return [Resources::EditImage] Edit source images with a text prompt.
       attr_reader :edit_image
+      # @return [Resources::DecomposeLayers] Separate an image into editable layers.
+      attr_reader :decompose_layers
 
       def initialize(api_key: nil, **options)
         super
         @text_to_image = Resources::TextToImage.new(http)
         @edit_image = Resources::EditImage.new(http)
+        @decompose_layers = Resources::DecomposeLayers.new(http)
       end
     end
   end

data/lib/runapi/seedream/contract_gen.rb

@@ -3,6 +3,26 @@
 module RunApi
   module Seedream
     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" => {

data/lib/runapi/seedream/resources/decompose_layers.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Seedream
+    module Resources
+      # Separates one image into a base image and independent layers.
+      class DecomposeLayers
+        include RunApi::Core::ResourceHelpers
+
+        ENDPOINT = "/api/v1/seedream/decompose_layers"
+        RESPONSE_CLASS = Types::DecomposeLayersResponse
+        COMPLETED_RESPONSE_CLASS = Types::CompletedDecomposeLayersResponse
+
+        def initialize(http)
+          @http = http
+        end
+
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
+        end
+
+        def create(options: nil, **params)
+          params = compact_params(params)
+          validate_contract!(CONTRACT["decompose-layers"], params)
+          request(:post, ENDPOINT, body: params, options: options)
+        end
+
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
+        end
+      end
+    end
+  end
+end

data/lib/runapi/seedream/types.rb

@@ -37,6 +37,19 @@ module RunApi
       end
 
       CompletedEditImageResponse = CompletedTextToImageResponse
+
+      class DecomposeLayersResponse < RunApi::Core::TaskResponse
+        required :id, String
+        optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
+        optional :base_image, -> { Image }
+        optional :layers, [-> { Image }]
+        optional :error, String
+      end
+
+      class CompletedDecomposeLayersResponse < DecomposeLayersResponse
+        required :base_image, -> { Image }
+        required :layers, [-> { Image }]
+      end
     end
   end
 end

data/lib/runapi/seedream.rb

@@ -5,6 +5,7 @@ require_relative "seedream/types"
 require_relative "seedream/contract_gen"
 require_relative "seedream/resources/text_to_image"
 require_relative "seedream/resources/edit_image"
+require_relative "seedream/resources/decompose_layers"
 require_relative "seedream/client"
 
 module RunApi

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-seedream
 version: !ruby/object:Gem::Version
-  version: 0.2.11
+  version: 0.2.13
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.4
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.4
+        version: 0.4.0
 description: The Seedream Ruby SDK is the language-specific package for Seedream on
   RunAPI. Use this package for image generation, image editing, and creative production
   workflows when your application needs request bodies, task status lookup, and consistent
@@ -40,6 +40,7 @@ files:
 - lib/runapi/seedream.rb
 - lib/runapi/seedream/client.rb
 - lib/runapi/seedream/contract_gen.rb
+- lib/runapi/seedream/resources/decompose_layers.rb
 - lib/runapi/seedream/resources/edit_image.rb
 - lib/runapi/seedream/resources/text_to_image.rb
 - lib/runapi/seedream/types.rb