runapi-nano-banana 0.2.5 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3eee5aec4249b7737dbe3f214b9b8a201fbeb1896b4a5173c008d98ed2295f3e
-  data.tar.gz: 4989e0ecf05cc139c723fa0287789e0365b7ab43dc69204bb71424d3484d34ce
+  metadata.gz: d6f82c6314ecf49b04a4288ac55dbde5361e2eeeb5b8fcdf897189bd9804902c
+  data.tar.gz: 25d20779667b0de9393725fee52f24ad38acc10ac623b634dcb343465b60688a
 SHA512:
-  metadata.gz: 45090f80b467bbab5d7b28081a862414da36afcc5af4db686b67b993f2a1b027b038f7b6e837d82ca4a0d4d6bcc896356f1c86efb333e641d3e9902549561376
-  data.tar.gz: 5167144f59027642ec67cd602df5eac0dfc560f61ac641b228e48c6666ea06a00cc1c82923a5ca1fe9d3b827ae32113d8fe2fc400d40020578a785b968845e30
+  metadata.gz: 8f1dbb06ac32a0e5673b25b8aedaeb3e9ab287e939cf645452905eb0bd89d1eac9600b23bf9cfa5ca140c509fa3ad31bf7009459967d603d3b0a3b6bff6a4ab5
+  data.tar.gz: d1757bc0ef46c180d40a68e63cf40bade362839ec58aac9c96e7dc9abd05764b46e939dd21875191dbe12cf1b529df63860a15fde15529c075bcd6f2a4d57c5f

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::NanoBanana` error classes when building image jobs, Rails workers, or scripts. The available resources include generations, and edits. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

data/lib/runapi/nano_banana/client.rb

@@ -2,23 +2,25 @@
 
 module RunApi
   module NanoBanana
-    # NanoBanana image generation API client.
+    # 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.
     #
     # @example
     #   client = RunApi::NanoBanana::Client.new(api_key: "your-api-key")
     #   result = client.text_to_image.run(
-    #     model: "flux-kontext-pro", prompt: "A futuristic cityscape"
+    #     model: "nano-banana-pro", prompt: "A futuristic cityscape"
     #   )
-    class Client
-      # @return [Resources::TextToImage] Image generation operations.
-      # @return [Resources::EditImage] Image editing operations.
-      attr_reader :text_to_image, :edit_image
+    class Client < RunApi::Core::Client
+      # @return [Resources::TextToImage] Generate images from text prompts with optional reference image guidance.
+      attr_reader :text_to_image
+      # @return [Resources::EditImage] Edit existing images using text prompts and source images.
+      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)
         @edit_image = Resources::EditImage.new(http)
       end

data/lib/runapi/nano_banana/types.rb

@@ -3,14 +3,19 @@
 module RunApi
   module NanoBanana
     module Types
+      # Generation tiers: standard (fast), pro (higher res + more refs), v2 (longest prompts + extreme ratios).
       GENERATION_MODELS = %w[nano-banana nano-banana-pro nano-banana-2].freeze
+      # Dedicated editing model. Requires source images to transform.
       EDIT_MODELS = %w[nano-banana-edit].freeze
 
       BASE_ASPECT_RATIOS = %w[1:1 9:16 16:9 3:4 4:3 3:2 2:3 5:4 4:5 21:9 auto].freeze
+      # Full aspect ratio set including extreme panoramic ratios (1:4, 1:8, 4:1, 8:1) for v2.
       ASPECT_RATIOS = %w[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].freeze
+      # Output resolution tiers. Pro and v2 default to 1k; higher tiers increase generation time.
       OUTPUT_RESOLUTIONS = %w[1k 2k 4k].freeze
       OUTPUT_FORMATS = %w[png jpg jpeg].freeze
 
+      # A single generated or edited image result.
       class Image < RunApi::Core::BaseModel
         optional :url, String
         optional :origin_url, String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-nano-banana
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.6
 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 nano banana api Ruby SDK is the language-specific package for Nano
   Banana on RunAPI. Use this nano banana api package for text-to-image, image editing,
   and creative production flows when your application needs JSON request bodies, task