plagiarism-checker 4.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 692f431026f826b2ca580843b76fb78e526a4b33bf130e5baa2733445f52e371
-  data.tar.gz: d12e8ad811a38051846ed99ab4e2bd04735bc3a06489ac918bc7a16adfce8dc9
+  metadata.gz: 39393e80d6d74245563438a02c382e7de87c22acbc425ffd3d4e92a6b96d669f
+  data.tar.gz: 170a23529cde53bcc693de8f847200855b03964001c0d33f72af74fe804b6138
 SHA512:
-  metadata.gz: 51886d89ac8c1cf8976fcb3fdc25cdbfe6aff4b85752e5d2783a14b8d8b08b71f1c7c2861222bbd3374d7b3bbe114274df9bcccb252d2f2176ebc923768306a6
-  data.tar.gz: 035e2164be6ed073d7f17eb3e75aa8d6954ffa7028d668a3935ff0fc5540561e6e95df037799eb9554f5b4ee15bddbfd2610bf2294c7fc6d3803d8dc3394c2bd
+  metadata.gz: 4efd08769fac76f7f0846835cf977efd8190a91883f76df6e3576909328071cb9fcfcc6f382af6dd7a66dbba5139469045612b0ec2b829348ceea19786d5c316
+  data.tar.gz: a6640272ad89bc07d0f99c17562d549dcfc116cac4ddbca10846f066cc94cc702c058197ee99722a1e9136a679ba9207f70095d965b96fe3ff6849751f5e5aca

data/.gitignore

@@ -6,3 +6,12 @@
 /pkg/
 /spec/reports/
 /tmp/
+
+# Generated gem files
+*.gem
+plagiarism-checker-3.2.1.gem
+plagiarism-checker-3.5.0.gem
+plagiarism-checker-3.6.0.gem
+plagiarism-checker-3.6.1.gem
+plagiarism-checker-3.7.0.gem
+plagiarism-checker-4.0.0.gem

data/README.md

@@ -32,7 +32,6 @@ require 'base64'
 # --- Your Credentials ---
 USER_EMAIL = 'YOUR_EMAIL_ADDRESS'
 USER_API_KEY = 'YOUR_API_KEY'
-WEBHOOK_URL = 'https://your-server.com/webhook/{STATUS}'
 # --------------------
 
 begin
@@ -56,7 +55,7 @@ require 'base64'
 # --- Your Credentials ---
 USER_EMAIL = 'YOUR_EMAIL_ADDRESS'
 USER_API_KEY = 'YOUR_API_KEY'
-WEBHOOK_URL = 'https://your-server.com/webhook/{STATUS}'
+WEBHOOK_URL = 'https://your-server.com'
 # --------------------
 
 begin
@@ -65,7 +64,7 @@ begin
       'aGVsbG8gd29ybGQ=',
       'ruby.txt',
       Copyleaks::SubmissionProperties.new(
-        Copyleaks::SubmissionWebhooks.new("#{WEBHOOK_URL}/url-webhook/scan/#{scanId}/{STATUS}","#{WEBHOOK_URL}/url-webhook/new-result"),
+        Copyleaks::SubmissionWebhooks.new("#{WEBHOOK_URL}/webhook/{STATUS}","#{WEBHOOK_URL}/url-webhook/new-result"),
         true,
         'developer_payloads_test',
         true,
@@ -101,7 +100,6 @@ require 'base64'
 # --- Your Credentials ---
 USER_EMAIL = 'YOUR_EMAIL_ADDRESS'
 USER_API_KEY = 'YOUR_API_KEY'
-WEBHOOK_URL = 'https://your-server.com/webhook/{STATUS}'
 # --------------------
 
 begin
@@ -130,7 +128,6 @@ require 'base64'
 # --- Your Credentials ---
 USER_EMAIL = 'YOUR_EMAIL_ADDRESS'
 USER_API_KEY = 'YOUR_API_KEY'
-WEBHOOK_URL = 'https://your-server.com/webhook/{STATUS}'
 # --------------------
 
 begin
@@ -160,27 +157,28 @@ require 'base64'
 # --- Your Credentials ---
 USER_EMAIL = 'YOUR_EMAIL_ADDRESS'
 USER_API_KEY = 'YOUR_API_KEY'
-WEBHOOK_URL = 'https://your-server.com/webhook/{STATUS}'
 # --------------------
 
 begin
- scanId = DateTime.now.strftime('%Q').to_s
+    scanId = DateTime.now.strftime('%Q').to_s
+    labelsArray=[
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::ADULT_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::TOXIC_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::VIOLENT_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::PROFANITY_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::SELF_HARM_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::HARASSMENT_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::HATE_SPEECH_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::DRUGS_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::FIREARMS_V1),
+      Copyleaks::CopyleaksTextModerationLabel.new(Copyleaks::CopyleaksTextModerationConstants::CYBERSECURITY_V1)
+    ]
+    
     text_moderation_request = Copyleaks::CopyleaksTextModerationRequestModel.new(
       text: "This is some text to scan.",
       sandbox: true,
-      language: "en",
-      labels: [
-        { id: "adult-v1" },
-        { id: "toxic-v1" },
-        { id: "violent-v1" },
-        { id: "profanity-v1" },
-        { id: "self-harm-v1" },
-        { id: "harassment-v1" },
-        { id: "hate-speech-v1" },
-        { id: "drugs-v1" },
-        { id: "firearms-v1" },
-        { id: "cybersecurity-v1" }
-      ]
+      language: Copyleaks::CopyleaksTextModerationLanguages::ENGLISH,
+      labels: labelsArray
     )
     res = @copyleaks.text_moderation_client.submit_text(_authToken, scanId, text_moderation_request)
 
@@ -195,7 +193,44 @@ For a full guide please refer to our step by step [Guide](https://docs.copyleaks
 
 For a detailed understanding of the Text moderation process, refer to the Copyleaks text moderation Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/text-moderation/check/)
 ##
-## Further Resources
+### AI Image Detection
+Determine if a given image was generated or partially generated by an AI.
+
+```ruby
+    require 'copyleaks'
+    require 'base64'
+    # --- Your Credentials ---
+    USER_EMAIL = 'YOUR_EMAIL_ADDRESS'
+    USER_API_KEY = 'YOUR_API_KEY'
+    # --------------------
+  begin
+      puts "Submitting a new image for AI image detection..."
+      
+      scanId = DateTime.now.strftime('%Q').to_s
+      
+      # Read and encode your image file to base64
+      image_path = "Path/to/your/image.jpg" # Update this path to your image
+      base64_image = Base64.strict_encode64(File.read(image_path))
+      
+      model = Copyleaks::CopyleaksAiImageDetectionRequestModel.new(
+        base64_image,
+        "image.jpg",
+        Copyleaks::CopyleaksAiImageDetectionModels::AI_IMAGE_1_ULTRA, 
+        true # sandbox mode
+      )
+      
+      res = copyleaks.ai_image_detection_client.submit_(authToken, scanId, model)
+    rescue StandardError => e
+      puts "Error in test_image_detection: #{e.message}"
+    end
+  end
+```
+For a full guide please refer to our step by step [Guide](https://docs.copyleaks.com/guides/ai-detector/ai-image-detection/)
+
+For a detailed understanding of the AI image detection process, refer to the Copyleaks AI image detection Endpoint [Documentation](https://docs.copyleaks.com/reference/actions/ai-image-detector/check/)
+
+##
+### Further Resources
 
 *   **Copyleaks API Dashboard:** Manage your API keys, monitor usage, and view analytics from your personalized dashboard. [Access Dashboard](https://api.copyleaks.com/dashboard)
 *   **Copyleaks SDK Documentation:** Explore comprehensive guides, API references, and code examples for seamless integration. [Read Documentation](https://docs.copyleaks.com/resources/sdks/overview/)

data/lib/copyleaks/ai_image_detection_client.rb

@@ -0,0 +1,54 @@
+#
+#  The MIT License(MIT)
+#
+#  Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a copy
+#  of this software and associated documentation files (the "Software"), to deal
+#  in the Software without restriction, including without limitation the rights
+#  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+#  copies of the Software, and to permit persons to whom the Software is
+#  furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice shall be included in all
+#  copies or substantial portions of the Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+#  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+#  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+#  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+#  SOFTWARE.
+# =
+
+module Copyleaks
+  class AIImageDetectionClient
+    def initialize(api_client)
+      @api_client = api_client
+    end
+
+    def submit_(authToken, scanId, submission)
+      raise 'scanId is Invalid, must be instance of String' if scanId.nil? || !scanId.instance_of?(String)
+      if submission.nil? || !submission.instance_of?(Copyleaks::CopyleaksAiImageDetectionRequestModel)
+        raise 'submission is Invalid, must be instance of type Copyleaks::CopyleaksAiImageDetectionRequestModel'
+      end
+
+      ClientUtils.verify_auth_token(authToken)
+
+      path = "/v1/ai-image-detector/#{scanId}/check"
+
+      headers = {
+        'Content-Type' => 'application/json',
+        'User-Agent' => Config.user_agent,
+        'Authorization' => "Bearer #{authToken.accessToken}"
+      }
+
+      request = Net::HTTP::Post.new(path, headers)
+      request.body = submission.to_json
+
+      res = ClientUtils.handle_response(@api_client.request(request), 'submit_image_detection')
+      res
+    end
+  end
+end

data/lib/copyleaks/api.rb

@@ -27,6 +27,7 @@ require 'date'
 require_relative 'ai_detection_client.rb'
 require_relative 'writing_assistant_client.rb'
 require_relative 'text_moderation_client.rb'
+require_relative 'ai_image_detection_client.rb'
 require_relative 'utils/copyleaks_client.utils'
 
 module Copyleaks
@@ -45,6 +46,7 @@ module Copyleaks
       @ai_detection_client = AIDetectionClient.new(@api_client)
       @writing_assistant_client = WritingAssistantClient.new(@api_client)
       @text_moderation_client = TextModerationClient.new(@api_client)
+      @ai_image_detection_client = AIImageDetectionClient.new(@api_client)
     end
 
     # Login to Copyleaks authentication server.
@@ -461,5 +463,9 @@ module Copyleaks
     def text_moderation_client
       @text_moderation_client
     end
+
+    def ai_image_detection_client
+      @ai_image_detection_client
+    end
   end
 end

data/lib/copyleaks/models/constants/CopyleaksAiImageDetectionModels.rb

@@ -0,0 +1,28 @@
+#
+#  The MIT License(MIT)
+#
+#  Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a copy
+#  of this software and associated documentation files (the "Software"), to deal
+#  in the Software without restriction, including without limitation the rights
+#  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+#  copies of the Software, and to permit persons to whom the Software is
+#  furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice shall be included in all
+#  copies or substantial portions of the Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+#  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+#  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+#  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+#  SOFTWARE.
+# =
+module Copyleaks
+  class CopyleaksAiImageDetectionModels
+    AI_IMAGE_1_ULTRA = "ai-image-1-ultra"
+  end
+end

data/lib/copyleaks/models/constants/index.rb

@@ -24,6 +24,8 @@
 
 require_relative 'CopyleaksTextModerationConstants.rb'
 require_relative 'CopyleaksTextModerationLanguages.rb'
+require_relative 'CopyleaksAiImageDetectionModels.rb'
+
 
 module Copyleaks
 end

data/lib/copyleaks/models/imageDetection/requests/CopyleaksAiImageDetectionRequestModel.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module Copyleaks
+
+        # Request model for Copyleaks AI image detection.
+        # The request body is a JSON object containing the image to analyze.
+        class CopyleaksAiImageDetectionRequestModel
+          attr_accessor :base64, :file_name, :model, :sandbox
+
+          # Initialize a new CopyleaksAiImageDetectionRequestModel
+          #
+          # @param base64 [String] The base64-encoded image data to be analyzed for AI generation
+          # @param file_name [String] The name of the image file including its extension
+          # @param model [String] The AI detection model to use for analysis
+          # @param sandbox [Boolean] Use sandbox mode to test integration (default: false)
+          def initialize(base64, file_name, model, sandbox = false)
+            @base64 = base64
+            @file_name = file_name
+            @model = model
+            @sandbox = sandbox
+          end
+
+          # The base64-encoded image data to be analyzed for AI generation.
+          #
+          # Requirements:
+          # - Minimum 512×512px, maximum 16 megapixels, less than 32MB
+          # - Supported formats: PNG, JPEG, BMP, WebP, HEIC/HEIF
+          #
+          # @example "aGVsbG8gd29ybGQ="
+          # @return [String] Base64-encoded image data
+          attr_reader :base64
+
+          # The name of the image file including its extension.
+          #
+          # Requirements:
+          # - Supported extensions: .png, .bmp, .jpg, .jpeg, .webp, .heic, .heif
+          # - Maximum 255 characters
+          #
+          # @example "my-image.png"
+          # @return [String] Image file name
+          attr_reader :file_name
+
+          # The AI detection model to use for analysis.
+          # You can use either the full model name or its alias.
+          #
+          # Available models:
+          # - AI Image 1 Ultra: "ai-image-1-ultra-01-09-2025" (full name) or "ai-image-1-ultra" (alias)
+          #   AI image detection model. Produces an overlay of the detected AI segments.
+          #
+          # @example "ai-image-1-ultra-01-09-2025" or "ai-image-1-ultra"
+          # @return [String] Model name or alias
+          attr_reader :model
+
+          # Use sandbox mode to test your integration with the Copyleaks API without consuming any credits.
+          #
+          # Submit images for AI detection and get returned mock results, simulating Copyleaks' API functionality
+          # to ensure you have successfully integrated the API.
+          # This feature is intended to be used for development purposes only.
+          # Default value is false.
+          #
+          # @example false
+          # @return [Boolean] Sandbox mode flag
+          attr_reader :sandbox
+
+          # Convert the model to a hash for JSON serialization
+          #
+          # @return [Hash] Hash representation of the model
+          def to_hash
+            {
+              base64: @base64,
+              fileName: @file_name,
+              model: @model,
+              sandbox: @sandbox
+            }
+          end
+
+          # Convert the model to JSON
+          #
+          # @return [String] JSON representation of the model
+          def to_json(*args)
+            to_hash.to_json(*args)
+          end
+
+          # Validate the model data
+          #
+          # @raise [ArgumentError] If required fields are missing or invalid
+          def validate!
+            raise ArgumentError, 'base64 is required' if @base64.nil? || @base64.empty?
+            raise ArgumentError, 'file_name is required' if @file_name.nil? || @file_name.empty?
+            raise ArgumentError, 'model is required' if @model.nil? || @model.empty?
+            
+            validate_file_name!
+            validate_file_size!
+          end
+
+          private
+
+          # Validate file name format and extension
+          def validate_file_name!
+            raise ArgumentError, 'file_name exceeds maximum length of 255 characters' if @file_name.length > 255
+            
+            valid_extensions = %w[.png .bmp .jpg .jpeg .webp .heic .heif]
+            extension = File.extname(@file_name.downcase)
+            
+            unless valid_extensions.include?(extension)
+              raise ArgumentError, "Unsupported file extension: #{extension}. Supported: #{valid_extensions.join(', ')}"
+            end
+          end
+
+          # Validate base64 data size (basic check)
+          def validate_file_size!
+            # Basic size check - base64 data should not exceed ~42MB (32MB * 4/3 base64 overhead)
+            max_base64_size = 44_000_000 # Approximately 32MB when decoded
+            
+            if @base64.length > max_base64_size
+              raise ArgumentError, 'Image size exceeds maximum limit of 32MB'
+            end
+          end
+        end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionImageInfoModel.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # Information about the analyzed image.
+  class CopyleaksAiImageDetectionImageInfoModel
+    # Dimensions of the analyzed image.
+    attr_accessor :shape
+
+    # Optional metadata extracted from the image.
+    attr_accessor :metadata
+
+    # Initialize a new CopyleaksAiImageDetectionImageInfoModel
+    #
+    # @param shape [CopyleaksImageShapeModel] Dimensions of the analyzed image
+    # @param metadata [CopyleaksImageMetadataModel] Optional metadata extracted from the image
+    def initialize(shape: nil, metadata: nil)
+      @shape = shape
+      @metadata = metadata
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      shape = CopyleaksImageShapeModel.from_json(json_hash['shape']) if json_hash['shape']
+      metadata = CopyleaksImageMetadataModel.from_json(json_hash['metadata']) if json_hash['metadata']
+
+      new(shape: shape, metadata: metadata)
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'shape' => @shape ? JSON.parse(@shape.to_json) : nil,
+        'metadata' => @metadata ? JSON.parse(@metadata.to_json) : nil
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionResponseModel.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # Response model for Copyleaks AI image detection analysis.
+  # Contains the AI detection results, image information, and scan metadata.
+  class CopyleaksAiImageDetectionResponseModel
+    # The version of the AI detection model used for analysis.
+    attr_accessor :model
+
+    # RLE-encoded mask data containing arrays of start positions and lengths for AI-detected regions.
+    attr_accessor :result
+
+    # Summary statistics of the AI detection analysis.
+    attr_accessor :summary
+
+    # Information about the analyzed image.
+    attr_accessor :image_info
+
+    # Metadata about the scan operation.
+    attr_accessor :scanned_document
+
+    # Initialize a new CopyleaksAiImageDetectionResponseModel
+    #
+    # @param model [String] The version of the AI detection model used for analysis
+    # @param result [CopyleaksAiImageDetectionResultModel] RLE-encoded mask data containing arrays of start positions and lengths for AI-detected regions
+    # @param summary [CopyleaksAiImageDetectionSummaryModel] Summary statistics of the AI detection analysis
+    # @param image_info [CopyleaksAiImageDetectionImageInfoModel] Information about the analyzed image
+    # @param scanned_document [CopyleaksAiImageDetectionScannedDocumentModel] Metadata about the scan operation
+    def initialize(model: nil, result: nil, summary: nil, image_info: nil, scanned_document: nil)
+      @model = model
+      @result = result
+      @summary = summary
+      @image_info = image_info
+      @scanned_document = scanned_document
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      result = CopyleaksAiImageDetectionResultModel.from_json(json_hash['result']) if json_hash['result']
+      summary = CopyleaksAiImageDetectionSummaryModel.from_json(json_hash['summary']) if json_hash['summary']
+      image_info = CopyleaksAiImageDetectionImageInfoModel.from_json(json_hash['imageInfo']) if json_hash['imageInfo']
+      scanned_document = CopyleaksAiImageDetectionScannedDocumentModel.from_json(json_hash['scannedDocument']) if json_hash['scannedDocument']
+
+      new(
+        model: json_hash['model'],
+        result: result,
+        summary: summary,
+        image_info: image_info,
+        scanned_document: scanned_document
+      )
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'model' => @model,
+        'result' => @result ? JSON.parse(@result.to_json) : nil,
+        'summary' => @summary ? JSON.parse(@summary.to_json) : nil,
+        'imageInfo' => @image_info ? JSON.parse(@image_info.to_json) : nil,
+        'scannedDocument' => @scanned_document ? JSON.parse(@scanned_document.to_json) : nil
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionResultModel.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # RLE-encoded mask data for AI-detected regions.
+  class CopyleaksAiImageDetectionResultModel
+    # Start positions of AI-detected segments in the flattened image array.
+    attr_accessor :starts
+
+    # Lengths of AI-detected segments corresponding to each start position.
+    attr_accessor :lengths
+
+    # Initialize a new CopyleaksAiImageDetectionResultModel
+    #
+    # @param starts [Array<Integer>] Start positions of AI-detected segments in the flattened image array
+    # @param lengths [Array<Integer>] Lengths of AI-detected segments corresponding to each start position
+    def initialize(starts: nil, lengths: nil)
+      @starts = starts
+      @lengths = lengths
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      new(
+        starts: json_hash['starts'],
+        lengths: json_hash['lengths']
+      )
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'starts' => @starts,
+        'lengths' => @lengths
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionScannedDocumentModel.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # Metadata about the AI image detection scan operation.
+  class CopyleaksAiImageDetectionScannedDocumentModel
+    # The unique identifier for this scan.
+    attr_accessor :scan_id
+
+    # The actual number of credits consumed by this scan.
+    attr_accessor :actual_credits
+
+    # The expected number of credits for this scan.
+    attr_accessor :expected_credits
+
+    # ISO 8601 timestamp of when the scan was created.
+    attr_accessor :creation_time
+
+    # Initialize a new CopyleaksAiImageDetectionScannedDocumentModel
+    #
+    # @param scan_id [String] The unique identifier for this scan
+    # @param actual_credits [Integer] The actual number of credits consumed by this scan
+    # @param expected_credits [Integer] The expected number of credits for this scan
+    # @param creation_time [String] ISO 8601 timestamp of when the scan was created
+    def initialize(scan_id: nil, actual_credits: nil, expected_credits: nil, creation_time: nil)
+      @scan_id = scan_id
+      @actual_credits = actual_credits
+      @expected_credits = expected_credits
+      @creation_time = creation_time
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      new(
+        scan_id: json_hash['scanId'],
+        actual_credits: json_hash['actualCredits'],
+        expected_credits: json_hash['expectedCredits'],
+        creation_time: json_hash['creationTime']
+      )
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'scanId' => @scan_id,
+        'actualCredits' => @actual_credits,
+        'expectedCredits' => @expected_credits,
+        'creationTime' => @creation_time
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionSummaryModel.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # Summary statistics of the AI detection analysis.
+  class CopyleaksAiImageDetectionSummaryModel
+    # Percentage of pixels suspected to be human-created.
+    # Range: 0.0-1.0
+    attr_accessor :human
+
+    # Percentage of pixels suspected to be AI-generated.
+    # Range: 0.0-1.0
+    attr_accessor :ai
+
+    # Initialize a new CopyleaksAiImageDetectionSummaryModel
+    #
+    # @param human [Float] Percentage of pixels suspected to be human-created (0.0-1.0)
+    # @param ai [Float] Percentage of pixels suspected to be AI-generated (0.0-1.0)
+    def initialize(human: nil, ai: nil)
+      @human = human
+      @ai = ai
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      new(
+        human: json_hash['human'],
+        ai: json_hash['ai']
+      )
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'human' => @human,
+        'ai' => @ai
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksImageMetadataModel.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # Optional metadata extracted from the image.
+  class CopyleaksImageMetadataModel
+    # Timestamp when the image was created (if available).
+    attr_accessor :issued_time
+
+    # The AI service or tool that created the image (if detected).
+    attr_accessor :issued_by
+
+    # The application or device used to create the image.
+    attr_accessor :app_or_device_used
+
+    # Initialize a new CopyleaksImageMetadataModel
+    #
+    # @param issued_time [String] Timestamp when the image was created (if available)
+    # @param issued_by [String] The AI service or tool that created the image (if detected)
+    # @param app_or_device_used [String] The application or device used to create the image
+    def initialize(issued_time: nil, issued_by: nil, app_or_device_used: nil)
+      @issued_time = issued_time
+      @issued_by = issued_by
+      @app_or_device_used = app_or_device_used
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      new(
+        issued_time: json_hash['issuedTime'],
+        issued_by: json_hash['issuedBy'],
+        app_or_device_used: json_hash['appOrDeviceUsed']
+      )
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'issuedTime' => @issued_time,
+        'issuedBy' => @issued_by,
+        'appOrDeviceUsed' => @app_or_device_used
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/imageDetection/responses/CopyleaksImageShapeModel.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# ********************************************************************************
+# The MIT License(MIT)
+#
+# Copyright(c) 2016 Copyleaks LTD (https://copyleaks.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+# ********************************************************************************
+
+module Copyleaks
+  # Dimensions of the analyzed image.
+  class CopyleaksImageShapeModel
+    # Height of the image in pixels.
+    attr_accessor :height
+
+    # Width of the image in pixels.
+    attr_accessor :width
+
+    # Initialize a new CopyleaksImageShapeModel
+    #
+    # @param height [Integer] Height of the image in pixels
+    # @param width [Integer] Width of the image in pixels
+    def initialize(height: nil, width: nil)
+      @height = height
+      @width = width
+    end
+
+    # Create instance from JSON hash
+    def self.from_json(json_hash)
+      return nil if json_hash.nil?
+
+      new(
+        height: json_hash['height'],
+        width: json_hash['width']
+      )
+    end
+
+    # Convert to JSON
+    def to_json(*args)
+      {
+        'height' => @height,
+        'width' => @width
+      }.to_json(*args)
+    end
+  end
+end

data/lib/copyleaks/models/index.rb

@@ -40,5 +40,14 @@ require_relative 'textModeration/responses/submodules/TextModerationScannedDocum
 require_relative 'textModeration/responses/submodules/TextModerationsLegend.rb'
 require_relative 'textModeration/responses/CopyleaksTextModerationResponseModel.rb'
 
+require_relative 'imageDetection/requests/CopyleaksAiImageDetectionRequestModel.rb'
+require_relative 'imageDetection/responses/CopyleaksAiImageDetectionResponseModel.rb'
+require_relative 'imageDetection/responses/CopyleaksAiImageDetectionResultModel.rb'
+require_relative 'imageDetection/responses/CopyleaksAiImageDetectionImageInfoModel.rb'
+require_relative 'imageDetection/responses/CopyleaksAiImageDetectionScannedDocumentModel.rb'
+require_relative 'imageDetection/responses/CopyleaksAiImageDetectionSummaryModel.rb'
+require_relative 'imageDetection/responses/CopyleaksImageMetadataModel.rb'
+require_relative 'imageDetection/responses/CopyleaksImageShapeModel.rb'
+
 module Copyleaks
 end

data/lib/copyleaks/version.rb

@@ -1,3 +1,3 @@
 module Copyleaks
-  VERSION = '4.0.0'
+  VERSION = '4.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: plagiarism-checker
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.1.0
 platform: ruby
 authors:
 - Copyleaks ltd
@@ -30,9 +30,11 @@ files:
 - bin/setup
 - lib/copyleaks.rb
 - lib/copyleaks/ai_detection_client.rb
+- lib/copyleaks/ai_image_detection_client.rb
 - lib/copyleaks/api.rb
 - lib/copyleaks/app.config.rb
 - lib/copyleaks/models/auth_token.rb
+- lib/copyleaks/models/constants/CopyleaksAiImageDetectionModels.rb
 - lib/copyleaks/models/constants/CopyleaksTextModerationConstants.rb
 - lib/copyleaks/models/constants/CopyleaksTextModerationLanguages.rb
 - lib/copyleaks/models/constants/index.rb
@@ -48,6 +50,14 @@ files:
 - lib/copyleaks/models/exports/export_results.rb
 - lib/copyleaks/models/exports/index.rb
 - lib/copyleaks/models/id_object.rb
+- lib/copyleaks/models/imageDetection/requests/CopyleaksAiImageDetectionRequestModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionImageInfoModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionResponseModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionResultModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionScannedDocumentModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksAiImageDetectionSummaryModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksImageMetadataModel.rb
+- lib/copyleaks/models/imageDetection/responses/CopyleaksImageShapeModel.rb
 - lib/copyleaks/models/index.rb
 - lib/copyleaks/models/start_request_model.rb
 - lib/copyleaks/models/submissions/ai_detection/ai_detection_submission_model.rb