leoandruby 0.4.5 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1367cd52f309343a6083ed35dceace0d85491460b0a4e89c61c013bc39b2cf5
-  data.tar.gz: 4424b97d4adf3b674eaa76f23d7c8047f2b4973c317835935dc2f520bf650c66
+  metadata.gz: 3108cca83586240d0b714c41e37b521f53505dedfd2410eb310cd53e81008a40
+  data.tar.gz: 5d4070cf2d3fe87c7ccdbd0b3faf80e4350bb1ef4c8e39f5256583585ab70fe3
 SHA512:
-  metadata.gz: '09ba19275cccfcc57783db80e855e1a4284b54f67f02ba88872541ffeb160a92fc6cce69e176c8e1f7c860c47e4224b4ac306da5bc88c0d95451eea8ab017b5b'
-  data.tar.gz: 20a7213cc2b2308918569b1d7c02922dcb1d7194409c25c3554bfc1a2aa54a70bd992813c9877b565a9f8aea9edbacd603e1e6384d3360d9c44215d3dea8772d
+  metadata.gz: a294f8fabede70c00c5af41614083b7263b31dd4d1fcf1bcdaa3f3f2c4c9dd6f5fd2d9aad291723a0147b51fc243af632217f5f1438586694de8de24cdebcabc
+  data.tar.gz: 8e5cac2eec85b83f2a2637c9e333c628ab7fa3731dc89ed43d9ec8e8d2e25225150dc603dbba6fb851408580fd4d4bcf8566e15e2bb8a5d0b794e9f40dcb9d0a

data/CHANGELOG.md

@@ -1,4 +1,57 @@
 # Changelog
+
+## [0.5.3] - 2024-04-29
+
+### Added
+- Expanded `generate_image` method to support new parameters from Leonardo.ai's PhotoReal v2 API:
+  - `negative_prompt`
+  - `presetStyle`
+  - `photoRealVersion`
+- Introduced intelligent default values for key generation parameters:
+  - Defaults to **Kino XL** model if no `model_id` is provided.
+  - Defaults `alchemy` to `true`.
+  - Defaults `photoReal` to `true`.
+  - Defaults `photoRealVersion` to `"v2"`.
+  - Defaults `presetStyle` to `"DYNAMIC"`.
+- Added internal constant `DEFAULT_PHOTO_REAL_MODEL_ID` for clarity and maintainability.
+
+### Changed
+- Improved `handle_response` method to parse and log detailed Leonardo.ai error responses.
+- Enhanced error reporting to Rails logs for faster and more accurate debugging.
+- Introduced validation to raise informative `ArgumentError` if `prompt`, `height`, or `width` are missing when generating an image.
+
+### Fixed
+- Ensured `negative_prompt` is correctly handled as an optional parameter during image generation.
+
+---
+
+
+
+## [0.5.2] - 2025-04-29
+
+### Added
+- Improved API error handling for Leonardo.ai failures.
+- More detailed error logs to assist Rails diagnosis.
+
+### Fixed
+- Minor consistency improvements.
+
+## [0.5.1] - 2025-04-28
+
+### Added
+- Enhanced error handling with detailed API response messages
+- Improved documentation for troubleshooting common API errors
+- Added support for model-specific parameter validation
+
+### Changed
+- Updated error handling to include API response body in error messages
+- Improved parameter validation for model-specific requirements
+
+### Fixed
+- Resolved issues with model ID validation
+- Fixed parameter handling for model-specific constraints
+- Addressed compatibility issues with Leonardo.ai API updates
+
 ## [0.4.5] - 2025-04-28
 ### Added
 - _Describe new features here._

data/README.md

@@ -14,6 +14,7 @@
 - Webhook support to handle asynchronous image generation results.
 - Rails generator for setting up webhook integration effortlessly.
 - Simple and intuitive Ruby interface for interacting with the Leonardo.ai API.
+- Advanced image generation features including Alchemy, PhotoReal, and preset styles.
 
 ---
 
@@ -70,12 +71,27 @@ generation_response = client.generate_image(
   model_id: '6bef9f1b-29cb-40c7-b9df-32b51c1f67d3',
   width: 512,
   height: 512,
-  num_images: 1 # Optional, defaults to 1 if not specified
+  num_images: 1, # Optional, defaults to 1 if not specified
+  alchemy: true, # Optional, enables Alchemy feature
+  photo_real: true, # Optional, enables PhotoReal feature
+  photo_real_strength: 0.5, # Optional, controls PhotoReal effect strength (0.0 to 1.0)
+  preset_style: 'CINEMATIC' # Optional, applies preset styles
 )
 
 generation_id = generation_response['sdGenerationJob']['generationId']
 ```
 
+### Advanced Image Generation Options
+
+The `generate_image` method supports several advanced options to enhance your image generation:
+
+- `alchemy`: Enable/disable the Alchemy feature for enhanced image quality
+- `photo_real`: Enable/disable the PhotoReal feature for photorealistic results
+- `photo_real_strength`: Control the strength of the PhotoReal effect (0.0 to 1.0)
+- `preset_style`: Apply preset styles like 'CINEMATIC', 'ANIME', 'CREATIVE', etc.
+
+All advanced options are optional and can be used in combination to achieve the desired result.
+
 ### 3. List Available Models
 
 You can fetch a list of all available platform models using the `list_models` method:
@@ -100,7 +116,7 @@ puts image_response
 
 ## Webhook Integration (Rails)
 
-LeoAndRuby supports asynchronous image generation through Leonardo.ai’s webhook feature. This allows your application to automatically process results when the image generation is complete.
+LeoAndRuby supports asynchronous image generation through Leonardo.ai's webhook feature. This allows your application to automatically process results when the image generation is complete.
 
 ### Generate a Webhook Controller
 
@@ -147,7 +163,11 @@ generation_response = client.generate_image(
   model_id: '6bef9f1b-29cb-40c7-b9df-32b51c1f67d3',
   width: 1024,
   height: 768,
-  num_images: 1 # Optional, defaults to 1 if not specified
+  num_images: 1, # Optional, defaults to 1 if not specified
+  alchemy: true, # Enable Alchemy for enhanced quality
+  photo_real: true, # Enable PhotoReal for photorealistic results
+  photo_real_strength: 0.7, # Set PhotoReal strength
+  preset_style: 'CINEMATIC' # Apply cinematic style
 )
 
 generation_id = generation_response['sdGenerationJob']['generationId']

data/lib/leoandruby/client.rb

@@ -1,16 +1,34 @@
+# frozen_string_literal: true
+
 require "net/http"
 require "json"
 require "uri"
 
 module LeoAndRuby
   class Client
-    API_BASE_URL = "https://cloud.leonardo.ai/api/rest/v1".freeze
+    API_BASE_URL = "https://cloud.leonardo.ai/api/rest/v1"
+    DEFAULT_PHOTO_REAL_MODEL_ID = "aa77f04e-3eec-4034-9c07-d0f619684628"
 
     def initialize(api_key)
       @api_key = api_key
     end
 
-    def generate_image(prompt:, model_id:, width:, height:, num_images: 1, alchemy: nil, photo_real: nil, photo_real_strength: nil, preset_style: nil)
+    def generate_image(
+      prompt:, height:, width:,
+      model_id: nil,
+      negative_prompt: nil,
+      alchemy: true,
+      preset_style: "DYNAMIC",
+      photo_real: true,
+      photo_real_version: "v2",
+      num_images: 1
+    )
+      raise ArgumentError, "Prompt must be provided" if prompt.nil? || prompt.strip.empty?
+      raise ArgumentError, "Height must be provided" if height.nil?
+      raise ArgumentError, "Width must be provided" if width.nil?
+
+      model_id ||= DEFAULT_PHOTO_REAL_MODEL_ID
+
       uri = URI("#{API_BASE_URL}/generations")
       request = Net::HTTP::Post.new(uri)
       request["Accept"] = "application/json"
@@ -20,14 +38,16 @@ module LeoAndRuby
       body = {
         prompt: prompt,
         modelId: model_id,
-        width: width,
         height: height,
-        num_images: num_images
+        width: width,
+        num_images: num_images,
+        alchemy: alchemy,
+        presetStyle: preset_style,
+        photoReal: photo_real,
+        photoRealVersion: photo_real_version
       }
-      body[:alchemy] = alchemy unless alchemy.nil?
-      body[:photoReal] = photo_real unless photo_real.nil?
-      body[:photoRealStrength] = photo_real_strength unless photo_real_strength.nil?
-      body[:presetStyle] = preset_style unless preset_style.nil?
+
+      body[:negative_prompt] = negative_prompt unless negative_prompt.nil?
 
       request.body = body.to_json
 
@@ -71,7 +91,24 @@ module LeoAndRuby
       when Net::HTTPSuccess
         JSON.parse(response.body)
       else
-        raise "HTTP Error: #{response.code} - #{response.message}"
+        begin
+          error_body = JSON.parse(response.body)
+          error_message = if error_body.is_a?(Hash)
+            error_body["message"] || error_body["error"] || error_body.to_s
+          else
+            error_body.to_s
+          end
+        rescue JSON::ParserError
+          error_message = response.body
+        end
+
+        full_error = <<~ERROR
+          Leonardo.ai API Error:
+          HTTP Status: #{response.code} #{response.message}
+          Response Body: #{error_message}
+        ERROR
+
+        raise full_error.strip
       end
     end
   end

data/lib/leoandruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LeoAndRuby
-  VERSION = "0.4.5"
+  VERSION = "0.5.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leoandruby
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.5.3
 platform: ruby
 authors:
 - Richard HW Baldwin
@@ -24,9 +24,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
-description: LeoAndRuby is a Ruby gem for integrating with the Leonardo.ai API, enabling
-  seamless image generation within Ruby applications. It provides a simple and intuitive
-  interface for creating, managing, and retrieving AI-generated images.
+description: LeoAndRuby integrates with the Leonardo.ai API, enabling seamless AI-powered
+  image generation in Ruby and Rails applications with simple, intuitive interfaces.
 email:
 - richard@empireofaustralia.com
 executables: []
@@ -54,13 +53,15 @@ metadata:
   homepage_uri: https://github.com/RWKotulski/LeoAndRuby
   source_code_uri: https://github.com/RWKotulski/LeoAndRuby
   changelog_uri: https://github.com/RWKotulski/LeoAndRuby/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/leoandruby
+  bug_tracker_uri: https://github.com/RWKotulski/LeoAndRuby/issues
   features: |
     - Generate stunning AI-powered images with minimal configuration.
     - Simple Ruby interface for interacting with the Leonardo.ai API.
-    - Supports asynchronous workflows with polling for image generation results.
-    - Fully configurable with support for API keys via environment variables.
-    - Easily integrates into Ruby and Rails applications.
+    - Supports asynchronous workflows with polling or webhook callbacks.
+    - Fully configurable with API key environment variables.
     - Webhook support with Rails generator for seamless integration.
+    - Rails 6+ compatible.
 post_install_message:
 rdoc_options: []
 require_paths: