runapi-qwen-2 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f3700e2cf81d87fa6bf94631a0f6d153cbc481a5b978f1f6a684f2986a8ebda
-  data.tar.gz: 948da5705c89ac0e4cab9b06c6a89e36426615d9b1e8656095a04e0ee2450dbc
+  metadata.gz: 2956586742f9d0861230f9896d032a1b9525325c3f18107eb3051133041ae180
+  data.tar.gz: d4639d731229589fa4e6b389771bbd1219ce62fe8488a86cc4671ef32a034ce3
 SHA512:
-  metadata.gz: d23d2d3fd38f3a16f49214ad0f122dbed63504eb61eaa463e41fa584a4a93efe7e61d2027997d996b8fb2d51d04edcbea50e12964e8b3a5c5f584f6cf86ecdcc
-  data.tar.gz: 981e76b782d1584f10e782be8d45e38a3a267d7f0adc8d47f799f01eaf0a16a3809278b42ffead6a04ae356aee77b114d8acc5a1bb2f91f5dafdce23f695fb89
+  metadata.gz: c668a2fbf31074afecc12aac9d4d493afe3fada577f0506f9993268355e2d1f3046f1d6db659812294ab0f71bc4d01c00ddd9a7d252c34b015ca0465f1f42e95
+  data.tar.gz: 7f14e473674084d4a1e76b28d28ab3a8703089ab91e9a80bc8310bf3b0e460b3960255ad76d7721098800bff50b9b380779fda48027566d7ea899325956e2fba

data/README.md

@@ -1,25 +1,25 @@
-# Qwen Image API Ruby SDK for RunAPI
+# Qwen 2 API Ruby SDK for RunAPI
 
-The qwen image api Ruby SDK is the language-specific package for Qwen 2 on RunAPI. Use this qwen image api package for text-to-image, image editing, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
+The Qwen 2 Ruby SDK is the language-specific package for Qwen 2 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 qwen image api README is the Ruby package guide inside the public `qwen2-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/qwen-2; for API reference, use https://runapi.ai/docs#qwen-2; for SDK docs, use https://runapi.ai/docs#sdk-qwen-2.
+This README is the Ruby package guide inside the public `qwen-2-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/qwen-2; for API reference, use https://runapi.ai/docs#qwen-2; for SDK docs, use https://runapi.ai/docs#sdk-qwen-2.
 
 ## Install
 
 ```bash
-gem install runapi-qwen2
+gem install runapi-qwen-2
 ```
 
 ## Quick start
 
 ```ruby
-require "runapi-qwen2"
+require "runapi/qwen_2"
 
 client = RunApi::Qwen2::Client.new
-task = client.generations.create(
+task = client.text_to_image.create(
   # Pass the Qwen 2 JSON request body from https://runapi.ai/docs#qwen-2.
 )
-status = client.generations.get(task.id)
+status = client.text_to_image.get(task.id)
 ```
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
@@ -28,7 +28,7 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## Language notes
 
-Use Ruby keyword arguments and the `RunApi::Qwen2` error classes when building image jobs, Rails workers, or scripts. The available resources include generations, image to images, and edits. 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::Qwen2` error classes when building image jobs, Rails workers, 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.
 
 ## Links
 

data/lib/runapi/qwen_2/client.rb

@@ -2,11 +2,9 @@
 
 module RunApi
   module Qwen2
-    # Qwen 2 image generation, remixing, and editing API client.
+    # Qwen 2 image generation and editing API client.
     #
-    # Three operations: pure text-to-image generation, remix (prompt-guided
-    # variation of a source image with configurable strength), and edit
-    # (targeted modifications to a source image).
+    # Text-to-image generation and targeted modifications to source images.
     #
     # @example
     #   client = RunApi::Qwen2::Client.new(api_key: "your-api-key")
@@ -18,15 +16,12 @@ module RunApi
     class Client < RunApi::Core::Client
       # @return [Resources::TextToImage] Generate images from text prompts.
       attr_reader :text_to_image
-      # @return [Resources::RemixImage] Create prompt-guided variations with adjustable strength (0 = faithful, 1 = creative).
-      attr_reader :remix_image
       # @return [Resources::EditImage] Apply targeted edits to a source image using natural-language prompts.
       attr_reader :edit_image
 
       def initialize(api_key: nil, **options)
         super
         @text_to_image = Resources::TextToImage.new(http)
-        @remix_image = Resources::RemixImage.new(http)
         @edit_image = Resources::EditImage.new(http)
       end
     end

data/lib/runapi/qwen_2/contract_gen.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Qwen2
+    CONTRACT = {
+      "edit-image" => {
+        "models" => ["qwen-2-edit-image"],
+        "fields_by_model" => {
+          "qwen-2-edit-image" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "2:3", "3:2", "3:4", "4:3", "9:16", "16:9", "21:9"]
+            },
+            "output_format" => {
+              "enum" => ["jpeg", "png"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_image_url" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "text-to-image" => {
+        "models" => ["qwen-2-text-to-image"],
+        "fields_by_model" => {
+          "qwen-2-text-to-image" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "3:4", "4:3", "9:16", "16:9"]
+            },
+            "output_format" => {
+              "enum" => ["png", "jpeg"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          }
+        }
+      }
+    }.freeze
+  end
+end

data/lib/runapi/qwen_2/resources/edit_image.rb

@@ -20,43 +20,27 @@ module RunApi
         #
         # @param params [Hash] edit-image parameters
         # @return [RunApi::Qwen2::Types::CompletedEditImageResponse] completed edit-image result
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
         # Create an edit-image task.
         #
         # @param params [Hash] edit-image parameters
         # @return [RunApi::Qwen2::Types::EditImageResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          validate_contract!(CONTRACT["edit-image"], params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get edit-image status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::Qwen2::Types::EditImageResponse] current edit-image status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-          raise Core::ValidationError, "source_image_url is required" unless param(params, :source_image_url)
-
-          model = param(params, :model)
-          unless Types::EDIT_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::EDIT_MODELS.join(", ")}"
-          end
-
-          validate_optional!(params, :aspect_ratio, Types::EDIT_IMAGE_ASPECT_RATIOS)
-          validate_optional!(params, :output_format, Types::OUTPUT_FORMATS)
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
       end
     end

data/lib/runapi/qwen_2/resources/text_to_image.rb

@@ -20,41 +20,27 @@ module RunApi
         #
         # @param params [Hash] text-to-image parameters
         # @return [RunApi::Qwen2::Types::CompletedTextToImageResponse] completed text-to-image result
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
         # Create a text-to-image task.
         #
         # @param params [Hash] text-to-image parameters
         # @return [RunApi::Qwen2::Types::TextToImageResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          validate_contract!(CONTRACT["text-to-image"], params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get text-to-image status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::Qwen2::Types::TextToImageResponse] current text-to-image status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-          model = param(params, :model)
-          unless Types::TEXT_TO_IMAGE_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::TEXT_TO_IMAGE_MODELS.join(", ")}"
-          end
-
-          validate_optional!(params, :aspect_ratio, Types::TEXT_TO_IMAGE_ASPECT_RATIOS)
-          validate_optional!(params, :output_format, Types::OUTPUT_FORMATS)
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
       end
     end

data/lib/runapi/qwen_2/types.rb

@@ -3,16 +3,6 @@
 module RunApi
   module Qwen2
     module Types
-      # All Qwen 2 model variants, each dedicated to a single operation type.
-      MODELS = %w[qwen-2-edit-image qwen-2-text-to-image qwen-2-remix-image].freeze
-      EDIT_MODELS = %w[qwen-2-edit-image].freeze
-      TEXT_TO_IMAGE_MODELS = %w[qwen-2-text-to-image].freeze
-      REMIX_IMAGE_MODELS = %w[qwen-2-remix-image].freeze
-      # Edit-image aspect ratios include ultra-wide 21:9; narrower set than generation.
-      EDIT_IMAGE_ASPECT_RATIOS = %w[1:1 2:3 3:2 3:4 4:3 9:16 16:9 21:9].freeze
-      TEXT_TO_IMAGE_ASPECT_RATIOS = %w[1:1 3:4 4:3 9:16 16:9].freeze
-      OUTPUT_FORMATS = %w[jpeg png].freeze
-
       # A single generated image result.
       class Image < RunApi::Core::BaseModel
         optional :url, String
@@ -27,7 +17,6 @@ module RunApi
       end
 
       class TextToImageResponse < ImageTaskResponse; end
-      class RemixImageResponse < ImageTaskResponse; end
       class EditImageResponse < ImageTaskResponse; end
 
       # Narrowed responses returned by +run()+ methods once polling observes
@@ -37,10 +26,6 @@ module RunApi
         required :images, [-> { Image }]
       end
 
-      class CompletedRemixImageResponse < RemixImageResponse
-        required :images, [-> { Image }]
-      end
-
       class CompletedEditImageResponse < EditImageResponse
         required :images, [-> { Image }]
       end

data/lib/runapi/qwen_2.rb

@@ -2,8 +2,8 @@
 
 require "runapi/core"
 require_relative "qwen_2/types"
+require_relative "qwen_2/contract_gen"
 require_relative "qwen_2/resources/text_to_image"
-require_relative "qwen_2/resources/remix_image"
 require_relative "qwen_2/resources/edit_image"
 require_relative "qwen_2/client"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-qwen-2
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - RunAPI
@@ -15,18 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
-description: The qwen image api Ruby SDK is the language-specific package for Qwen
-  2 on RunAPI. Use this qwen image api package for text-to-image, image editing, and
-  creative production flows when your application needs JSON request bodies, task
-  status lookup, and consistent RunAPI errors in Ruby.
+        version: 0.3.0
+description: The Qwen 2 Ruby SDK is the language-specific package for Qwen 2 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.
 email:
 - contact@runapi.ai
 executables: []
@@ -39,17 +39,19 @@ files:
 - lib/runapi-qwen_2.rb
 - lib/runapi/qwen_2.rb
 - lib/runapi/qwen_2/client.rb
+- lib/runapi/qwen_2/contract_gen.rb
 - lib/runapi/qwen_2/resources/edit_image.rb
-- lib/runapi/qwen_2/resources/remix_image.rb
 - lib/runapi/qwen_2/resources/text_to_image.rb
 - lib/runapi/qwen_2/types.rb
 homepage: https://runapi.ai/models/qwen-2
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: qwen-2
   homepage_uri: https://runapi.ai/models/qwen-2
   documentation_uri: https://github.com/runapi-ai/qwen-2-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/qwen-2-sdk
+  bug_tracker_uri: https://github.com/runapi-ai/qwen-2-sdk/issues
   changelog_uri: https://github.com/runapi-ai/qwen-2-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
@@ -65,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.17
 specification_version: 4
-summary: Qwen Image API Ruby SDK for RunAPI
+summary: Qwen 2 API Ruby SDK for RunAPI
 test_files: []

data/lib/runapi/qwen_2/resources/remix_image.rb

@@ -1,63 +0,0 @@
-# frozen_string_literal: true
-
-module RunApi
-  module Qwen2
-    module Resources
-      # Qwen2 remix-image resource. Creates prompt-guided variations from a source image.
-      class RemixImage
-        include RunApi::Core::ResourceHelpers
-
-        ENDPOINT = "/api/v1/qwen_2/remix_image"
-
-        RESPONSE_CLASS = Types::RemixImageResponse
-        COMPLETED_RESPONSE_CLASS = Types::CompletedRemixImageResponse
-
-        def initialize(http)
-          @http = http
-        end
-
-        # Remix an image and wait until complete.
-        #
-        # @param params [Hash] remix-image parameters
-        # @return [RunApi::Qwen2::Types::CompletedRemixImageResponse] completed remix-image result
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
-        end
-
-        # Create a remix-image task.
-        #
-        # @param params [Hash] remix-image parameters
-        # @return [RunApi::Qwen2::Types::RemixImageResponse] task creation result with id
-        def create(**params)
-          params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
-        end
-
-        # Get remix-image status by task ID.
-        #
-        # @param id [String] task ID
-        # @return [RunApi::Qwen2::Types::RemixImageResponse] current remix-image status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-          raise Core::ValidationError, "source_image_url is required" unless param(params, :source_image_url)
-
-          model = param(params, :model)
-          unless Types::REMIX_IMAGE_MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::REMIX_IMAGE_MODELS.join(", ")}"
-          end
-
-          validate_optional!(params, :output_format, Types::OUTPUT_FORMATS)
-        end
-      end
-    end
-  end
-end