runapi-nano-banana 0.2.7 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 832dd3e77b5049f32c247319b78e0a05b8c5c7d71c4cc0e16a1626011ba9248b
-  data.tar.gz: 23d94cd56e9f85984d903d7c8b4c9e1582e58614a48eae82d1f6bdbdcf5c0e1a
+  metadata.gz: ff7379866c15e897669c566806533c0dac1222b5d776a9e7399310a4ab8b4642
+  data.tar.gz: acd9c5be4da48065a1c19ded49cf99e3fb46be88bd734187428c2b7317cc585f
 SHA512:
-  metadata.gz: ba6d8452a6ddc1fcc6d700e20943f7cc454f9ebf653e50bdfef36365fd0bb8543e6b961b6400ed3943c6f1c1fc86eec9d9a5116c213ee8cf9338e1726e4f5d50
-  data.tar.gz: 127d62230b0d4c6a9c5f00fa3a38f49447426dba48299babc64c4ba6d697e5bcaa53b0be2c9fce803a1322eeac44d2cc12d61e0cfa2c9bd318125952fd0409cf
+  metadata.gz: 766be94a6fd4a677e4fc81d09a09475f70605f3f0cbe73bc12e855dcee6301b36e4f0fac315f813f431beed0ee3fcc18db804e06585966bf2d24d96cbe410a85
+  data.tar.gz: 82977ca43c84d766356050a8d23d81060479b6857cebe60442500079e080a976a2df3a7679b20368463b8ba6b4bd375723e08918cb809f69c3a1bf0115d18a03

data/README.md

@@ -13,7 +13,7 @@ gem install runapi-nano-banana
 ## Quick start
 
 ```ruby
-require "runapi-nano-banana"
+require "runapi/nano_banana"
 
 client = RunApi::NanoBanana::Client.new
 task = client.text_to_image.create(

data/lib/runapi/nano_banana/client.rb

@@ -4,9 +4,8 @@ module RunApi
   module NanoBanana
     # NanoBanana image generation and editing API client.
     #
-    # Three generation tiers: standard (fast), pro (higher resolution, more
-    # reference images), and v2 (longest prompts, extreme aspect ratios, up to
-    # 14 reference images). Editing uses the dedicated +nano-banana-edit+ model.
+    # Generation tiers include standard, pro, v2, and v2 lite. Image editing
+    # supports +nano-banana-2-lite+ and the dedicated +nano-banana-edit+ model.
     #
     # @example
     #   client = RunApi::NanoBanana::Client.new(api_key: "your-api-key")

data/lib/runapi/nano_banana/contract_gen.rb

@@ -4,8 +4,23 @@ module RunApi
   module NanoBanana
     CONTRACT = {
       "edit-image" => {
-        "models" => ["nano-banana-edit"],
+        "models" => ["nano-banana-2-lite", "nano-banana-edit"],
         "fields_by_model" => {
+          "nano-banana-2-lite" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9", "auto"],
+              "required" => true
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 1,
+              "max" => 20000,
+              "length" => true
+            },
+            "source_image_urls" => {
+              "required" => true
+            }
+          },
           "nano-banana-edit" => {
             "aspect_ratio" => {
               "enum" => ["1:1", "9:16", "16:9", "3:4", "4:3", "3:2", "2:3", "5:4", "4:5", "21:9", "auto"]
@@ -17,10 +32,16 @@ module RunApi
               "required" => true
             }
           }
-        }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "nano-banana-2-lite"
+          },
+          "forbidden" => ["output_format"]
+        }]
       },
       "text-to-image" => {
-        "models" => ["nano-banana", "nano-banana-2", "nano-banana-pro"],
+        "models" => ["nano-banana", "nano-banana-2", "nano-banana-2-lite", "nano-banana-pro"],
         "fields_by_model" => {
           "nano-banana" => {
             "aspect_ratio" => {
@@ -41,6 +62,18 @@ module RunApi
               "enum" => ["1k", "2k", "4k"]
             }
           },
+          "nano-banana-2-lite" => {
+            "aspect_ratio" => {
+              "enum" => ["1:1", "1:4", "1:8", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "8:1", "9:16", "16:9", "21:9", "auto"],
+              "required" => true
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 1,
+              "max" => 20000,
+              "length" => true
+            }
+          },
           "nano-banana-pro" => {
             "aspect_ratio" => {
               "enum" => ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9", "auto"]
@@ -52,7 +85,13 @@ module RunApi
               "enum" => ["1k", "2k", "4k"]
             }
           }
-        }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "nano-banana-2-lite"
+          },
+          "forbidden" => ["output_resolution", "output_format"]
+        }]
       }
     }.freeze
   end

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

@@ -4,11 +4,12 @@ module RunApi
   module NanoBanana
     module Resources
       # NanoBanana image editing resource.
-      # Edit existing images using text prompts and reference images.
+      # Edit existing images using text prompts and source images.
       class EditImage
         include RunApi::Core::ResourceHelpers
 
         ENDPOINT = "/api/v1/nano_banana/edit_image"
+        DEFAULT_MODEL = "nano-banana-2-lite"
 
         RESPONSE_CLASS = Types::EditImageResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedEditImageResponse
@@ -21,27 +22,28 @@ module RunApi
         #
         # @param params [Hash] edit parameters
         # @return [RunApi::NanoBanana::Types::CompletedEditImageResponse] completed edit with image results
-        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 image edit task.
         #
         # @param params [Hash] edit parameters
         # @return [RunApi::NanoBanana::Types::EditImageResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
+          params[:model] = DEFAULT_MODEL unless param(params, :model)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get edit status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::NanoBanana::Types::EditImageResponse] current edit status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private

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

@@ -9,6 +9,7 @@ module RunApi
         include RunApi::Core::ResourceHelpers
 
         ENDPOINT = "/api/v1/nano_banana/text_to_image"
+        DEFAULT_MODEL = "nano-banana-2-lite"
 
         RESPONSE_CLASS = Types::TextToImageResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedTextToImageResponse
@@ -19,29 +20,37 @@ module RunApi
 
         # Generate an image and wait until complete.
         #
-        # @param params [Hash] generation parameters
+        # @param params [Hash] generation parameters (see {#create} for accepted keys)
         # @return [RunApi::NanoBanana::Types::CompletedTextToImageResponse] completed generation with image results
-        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 image generation task.
         #
         # @param params [Hash] generation parameters
+        # @option params [String] :model optional; defaults to "nano-banana-2-lite"
+        # @option params [String] :prompt required; image description
+        # @option params [String] :aspect_ratio optional; required for nano-banana-2-lite
+        # @option params [String] :output_format optional; "png", "jpeg", or "jpg" (not supported by nano-banana-2-lite)
+        # @option params [String] :output_resolution optional; "1k", "2k", or "4k" (nano-banana-pro / nano-banana-2)
+        # @option params [Array<String>] :reference_image_urls optional; reference image URLs for visual
+        #   guidance (nano-banana / nano-banana-pro up to 8, nano-banana-2 up to 14, nano-banana-2-lite up to 10; <=30MB each)
         # @return [RunApi::NanoBanana::Types::TextToImageResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
+          params[:model] = DEFAULT_MODEL unless param(params, :model)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get generation status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::NanoBanana::Types::TextToImageResponse] current generation status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-nano-banana
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.10
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: 0.2.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.7
+        version: 0.2.11
 description: The Nano Banana Ruby SDK is the language-specific package for Nano Banana
   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