runapi-qwen-2 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7cbfba501dd88b37a82629dee1237753f030d6d92a06faac41f6165985aed21
-  data.tar.gz: ec3086cde57f139b0621c21c4e33e18a32aefbaf96be7f53c9757ddefb2631a4
+  metadata.gz: 1f3700e2cf81d87fa6bf94631a0f6d153cbc481a5b978f1f6a684f2986a8ebda
+  data.tar.gz: 948da5705c89ac0e4cab9b06c6a89e36426615d9b1e8656095a04e0ee2450dbc
 SHA512:
-  metadata.gz: c98213aac1b753e131550119533febb83cbf2e7543479750074458085e54d5be05772018d511f0cb3011aa70c55bbe1d53bce4691b410cfdea7758ade3c4f840
-  data.tar.gz: 7f564584fcde1efed7db34abf0a606d36ca59661b496f449cdf00d8137d9a91c32765e5289e357ed15a58627424dbf0ff91ee1a3335c5c6963045ae388550be8
+  metadata.gz: d23d2d3fd38f3a16f49214ad0f122dbed63504eb61eaa463e41fa584a4a93efe7e61d2027997d996b8fb2d51d04edcbea50e12964e8b3a5c5f584f6cf86ecdcc
+  data.tar.gz: 981e76b782d1584f10e782be8d45e38a3a267d7f0adc8d47f799f01eaf0a16a3809278b42ffead6a04ae356aee77b114d8acc5a1bb2f91f5dafdce23f695fb89

data/README.md

@@ -24,6 +24,8 @@ status = client.generations.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.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## 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.

data/lib/runapi/qwen_2/client.rb

@@ -2,7 +2,11 @@
 
 module RunApi
   module Qwen2
-    # Qwen2 text-to-image, remix-image, and edit-image API client.
+    # Qwen 2 image generation, remixing, 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).
     #
     # @example
     #   client = RunApi::Qwen2::Client.new(api_key: "your-api-key")
@@ -11,15 +15,16 @@ module RunApi
     #     prompt: "Replace the background with a neon-lit city skyline",
     #     source_image_url: "https://cdn.runapi.ai/public/samples/input.jpg"
     #   )
-    class Client
-      # @return [Resources::TextToImage, Resources::RemixImage, Resources::EditImage] Image operations.
-      attr_reader :text_to_image, :remix_image, :edit_image
+    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)
-        @api_key = Core::Auth.resolve_api_key(api_key)
-
-        client_options = Core::ClientOptions.new(api_key: @api_key, **options)
-        http = client_options.http_client || Core::HttpClient.new(client_options)
+        super
         @text_to_image = Resources::TextToImage.new(http)
         @remix_image = Resources::RemixImage.new(http)
         @edit_image = Resources::EditImage.new(http)

data/lib/runapi/qwen_2/types.rb

@@ -3,18 +3,22 @@
 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
       end
 
+      # Shared task result for all Qwen 2 image operations.
       class ImageTaskResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
@@ -26,6 +30,9 @@ module RunApi
       class RemixImageResponse < ImageTaskResponse; end
       class EditImageResponse < ImageTaskResponse; end
 
+      # Narrowed responses returned by +run()+ methods once polling observes
+      # +status: "completed"+. +images+ is required so consumers never
+      # have to null-check it on a successful task.
       class CompletedTextToImageResponse < TextToImageResponse
         required :images, [-> { Image }]
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-qwen-2
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        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