runapi-seedream 0.2.10 → 0.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7411c30bd86c2e767092fd1469f536b913a1b9958f17ac9c2053ddb5c1ecf521
-  data.tar.gz: '0283202729f397c967f529683489f400eec5dbbf5da90d3fbd5627e58f41e14d'
+  metadata.gz: 2656a2d0439dd8f5ccb5282b66fc1d43b18e0fc32495a41871c6033a9c56e3ea
+  data.tar.gz: 7a478828b7c2de132e32a280f6e1c8b4056eadb34c52f4092e712179bfa86a0c
 SHA512:
-  metadata.gz: c1fd9c14a0ab583ac18191003fb634ccd9317f95d266c5b6fe40fd176fde7203b113a4d5325211c1ab2c9d405db58c4c81f11e067f04f826d2ddec895b353150
-  data.tar.gz: c8db36ed036c45343589a19747cac5077873c26bc330da7d5ecefe252516af5bbb22762978a5e2a512c5f3d5c772c53d20055af2c93e94838f3e723191edbc9b
+  metadata.gz: 33b11a3cb4c6fd20c07eb89f7e059ae64d72d355879d1a9197cc57cabadb3acad71878e1dcf71c1b4caf3e8b1ce580bb5c23a4c7eda81fbcc6619d467a67382f
+  data.tar.gz: fd41da8643a0c7d487e829210972f2773fb5b804ae807596cb16e5807c628a9e7bddbf2c33e41850d04d621433558de3fae205ad24495e57428c46b12163b827

data/README.md

@@ -2,7 +2,7 @@
 
 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 RunAPI errors in Ruby.
 
-This README is the Ruby package guide inside the public `seedream-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/seedream; for API reference, use https://runapi.ai/docs#seedream; for SDK docs, use https://runapi.ai/docs#sdk-seedream.
+This README is the Ruby package guide inside the public `seedream-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/seedream; for API reference, use https://runapi.ai/docs/api/seedream/text-to-image; for SDK docs, use https://runapi.ai/docs/resources/sdks.
 
 ## Install
 
@@ -32,17 +32,17 @@ 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
 
 - Model page: https://runapi.ai/models/seedream
-- SDK docs: https://runapi.ai/docs#sdk-seedream
-- Product docs: https://runapi.ai/docs#seedream
+- SDK docs: https://runapi.ai/docs/resources/sdks
+- Product docs: https://runapi.ai/docs/api/seedream/text-to-image
 - Pricing and rate limits: https://runapi.ai/models/seedream/v4-text-to-image
 - Full catalog: https://runapi.ai/models
 - Repository: https://github.com/runapi-ai/seedream-sdk

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" => {
@@ -39,7 +59,7 @@ module RunApi
               "enum" => ["png", "jpeg"]
             },
             "output_quality" => {
-              "enum" => ["basic", "high"],
+              "enum" => ["basic", "high", "ultra"],
               "required" => true
             },
             "seed" => {
@@ -144,7 +164,7 @@ module RunApi
               "enum" => ["png", "jpeg"]
             },
             "output_quality" => {
-              "enum" => ["basic", "high"],
+              "enum" => ["basic", "high", "ultra"],
               "required" => true
             },
             "seed" => {

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.10
+  version: 0.2.12
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.3.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.3.5
 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