vgen-apimatic-sdk 0.0.1

data/lib/videogen/models/remove_entity_reference_request.rb

@@ -0,0 +1,73 @@
+# videogen
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Videogen
+  # RemoveEntityReferenceRequest Model.
+  class RemoveEntityReferenceRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The file id (e.g. `vg_file_...`) of the reference to remove.
+    # @return [String]
+    attr_accessor :file_id
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['file_id'] = 'fileId'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(file_id:, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @file_id = file_id
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      file_id = hash.key?('fileId') ? hash['fileId'] : nil
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      RemoveEntityReferenceRequest.new(file_id: file_id,
+                                       additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} file_id: #{@file_id}, additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} file_id: #{@file_id.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end

data/lib/videogen/models/scene_description_range.rb

@@ -0,0 +1,121 @@
+# videogen
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Videogen
+  # A description of the visuals to show during an absolute time range of the
+  # finished video.
+  class SceneDescriptionRange < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Start time of the range in seconds from the beginning of the video.
+    # @return [Float]
+    attr_accessor :start_seconds
+
+    # End time of the range in seconds from the beginning of the video. Must be
+    # greater than `startSeconds`.
+    # @return [Float]
+    attr_accessor :end_seconds
+
+    # What should be shown on screen during this range (e.g. the b-roll subject,
+    # on-screen text, or staging).
+    # @return [String]
+    attr_accessor :description
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['start_seconds'] = 'startSeconds'
+      @_hash['end_seconds'] = 'endSeconds'
+      @_hash['description'] = 'description'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(start_seconds:, end_seconds:, description:,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @start_seconds = start_seconds
+      @end_seconds = end_seconds
+      @description = description
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      start_seconds = hash.key?('startSeconds') ? hash['startSeconds'] : nil
+      end_seconds = hash.key?('endSeconds') ? hash['endSeconds'] : nil
+      description = hash.key?('description') ? hash['description'] : nil
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      SceneDescriptionRange.new(start_seconds: start_seconds,
+                                end_seconds: end_seconds,
+                                description: description,
+                                additional_properties: additional_properties)
+    end
+
+    # Validates an instance of the object from a given value.
+    # @param [SceneDescriptionRange | Hash] The value against the validation is performed.
+    def self.validate(value)
+      if value.instance_of? self
+        return (
+          APIHelper.valid_type?(value.start_seconds,
+                                ->(val) { val.instance_of? Float }) and
+            APIHelper.valid_type?(value.end_seconds,
+                                  ->(val) { val.instance_of? Float }) and
+            APIHelper.valid_type?(value.description,
+                                  ->(val) { val.instance_of? String })
+        )
+      end
+
+      return false unless value.instance_of? Hash
+
+      (
+        APIHelper.valid_type?(value['startSeconds'],
+                              ->(val) { val.instance_of? Float }) and
+          APIHelper.valid_type?(value['endSeconds'],
+                                ->(val) { val.instance_of? Float }) and
+          APIHelper.valid_type?(value['description'],
+                                ->(val) { val.instance_of? String })
+      )
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} start_seconds: #{@start_seconds}, end_seconds: #{@end_seconds},"\
+      " description: #{@description}, additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} start_seconds: #{@start_seconds.inspect}, end_seconds:"\
+      " #{@end_seconds.inspect}, description: #{@description.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end

data/lib/videogen/models/script_to_video_request.rb

@@ -0,0 +1,309 @@
+# videogen
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Videogen
+  # ScriptToVideoRequest Model.
+  class ScriptToVideoRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The narration script, used verbatim. This exact text is narrated and
+    # turned into a video — it is not rewritten or expanded.
+    # @return [String]
+    attr_accessor :script
+
+    # Aspect ratio as a width:height pair (e.g. 16 and 9 for 16:9). Not pixel
+    # dimensions.
+    # @return [AspectRatio]
+    attr_accessor :aspect_ratio
+
+    # Visual style for the generated b-roll.
+    # @return [WorkflowVisualStyle]
+    attr_accessor :visual_style
+
+    # How quickly visuals change. FAST shows more, shorter shots; SLOW holds
+    # each visual longer. Defaults to MEDIUM.
+    # @return [VisualPacing]
+    attr_accessor :visual_pacing
+
+    # Image generation quality tier for AI-generated visuals. Optional; when
+    # omitted, your account's Default AI quality for images is used (change it
+    # at https://app.videogen.io/settings/account). Only applies when
+    # `visualStyle.type` is AI_IMAGE; STOCK pulls existing footage and is
+    # unaffected.
+    # @return [ModelQuality4]
+    attr_accessor :quality
+
+    # Output language as a BCP-47 code (e.g. `en`, `es`, `fr`). Defaults to
+    # English.
+    # @return [String]
+    attr_accessor :language
+
+    # Catalog `displayName` (e.g. `Matilda`) or voice id from `GET
+    # /v1/resources/tts-voices` (e.g. `vg_voic_...`). A default voice is used
+    # when omitted. Any voice may be used here, including voices where
+    # `supportsDirectToolExecution` is false.
+    # @return [String]
+    attr_accessor :voice_id
+
+    # Speech rate multiplier, between 0.5 (half speed) and 2 (double speed).
+    # Defaults to the voice's default speed.
+    # @return [Float]
+    attr_accessor :voice_speed
+
+    # Recommended. Optional id of a built-in stock actor or an ACTOR entity
+    # (e.g. `vg_enti_...`) with an image reference. When set, narration is
+    # delivered by that actor avatar. Omit or pass `null` for voiceover without
+    # an avatar.
+    # @return [String]
+    attr_accessor :actor_entity_id
+
+    # Avatar generation quality tier. Applies when `actorEntityId` is provided.
+    # Optional; when omitted, your account's Default AI quality for avatars is
+    # used.
+    # @return [ModelQuality3]
+    attr_accessor :avatar_quality
+
+    # Optional file ids of images or videos to feature as b-roll (e.g.
+    # `["vg_file_..."]`). Upload files first via `POST /v1/files/upload`. Only
+    # image and video files are accepted.
+    # @return [Array[String]]
+    attr_accessor :featured_b_roll_file_ids
+
+    # Optional production notes for the AI that builds the video — visual
+    # direction that should not appear in the spoken narration (e.g. on-screen
+    # code or text to display, specific b-roll to feature, or scene-by-scene
+    # staging). Never spoken; keep the narration itself in `script`.
+    # @return [String]
+    attr_accessor :workflow_agent_context
+
+    # Optional timed scene descriptions guiding what to show on screen during
+    # each absolute time range of the video. Ranges must be sorted by
+    # `startSeconds` and non-overlapping. Omit to let the workflow choose
+    # visuals automatically.
+    # @return [Array[SceneDescriptionRange]]
+    attr_accessor :scenes
+
+    # Optional edits applied to the project after the video is built, in order.
+    # Each action runs asynchronously; the response returns one remix action id
+    # per action. Recommended for script-to-video: `ENABLE_CAPTIONS` to show and
+    # style captions, `CONVERT_IMAGES_TO_VIDEOS` to animate still images into
+    # clips, `ADD_TRANSITIONS` to stamp transitions between sections, and
+    # `SET_LOGO` to overlay a logo (this workflow has no native caption-style or
+    # logo fields). See the [Remix actions](/remix-actions) guide.
+    # @return [Array[Object]]
+    attr_accessor :remix_actions
+
+    # When true, the video's generated OUTPUT files (AI images, video clips,
+    # voiceover audio, avatars) are created as temporary: guaranteed available
+    # for 24 hours, after which they may be archived and later deleted. This
+    # also covers files produced by post-build remix actions (e.g. generated
+    # background music, image-to-video conversions). Use this when your
+    # integration downloads or re-hosts the results itself and does not need
+    # VideoGen to retain them. The project and its metadata are unaffected.
+    # Defaults to false.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_output_temporary
+
+    # When true, generated files are hidden from the VideoGen Media page by
+    # default. They remain accessible through the API. Defaults to false.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :hide_from_ui
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['script'] = 'script'
+      @_hash['aspect_ratio'] = 'aspectRatio'
+      @_hash['visual_style'] = 'visualStyle'
+      @_hash['visual_pacing'] = 'visualPacing'
+      @_hash['quality'] = 'quality'
+      @_hash['language'] = 'language'
+      @_hash['voice_id'] = 'voiceId'
+      @_hash['voice_speed'] = 'voiceSpeed'
+      @_hash['actor_entity_id'] = 'actorEntityId'
+      @_hash['avatar_quality'] = 'avatarQuality'
+      @_hash['featured_b_roll_file_ids'] = 'featuredBRollFileIds'
+      @_hash['workflow_agent_context'] = 'workflowAgentContext'
+      @_hash['scenes'] = 'scenes'
+      @_hash['remix_actions'] = 'remixActions'
+      @_hash['is_output_temporary'] = 'isOutputTemporary'
+      @_hash['hide_from_ui'] = 'hideFromUi'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        aspect_ratio
+        visual_pacing
+        quality
+        language
+        voice_id
+        voice_speed
+        actor_entity_id
+        avatar_quality
+        featured_b_roll_file_ids
+        workflow_agent_context
+        scenes
+        remix_actions
+        is_output_temporary
+        hide_from_ui
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        voice_id
+        actor_entity_id
+      ]
+    end
+
+    def initialize(script:, visual_style:, aspect_ratio: SKIP,
+                   visual_pacing: VisualPacing::MEDIUM, quality: SKIP,
+                   language: SKIP, voice_id: SKIP, voice_speed: SKIP,
+                   actor_entity_id: SKIP, avatar_quality: SKIP,
+                   featured_b_roll_file_ids: SKIP, workflow_agent_context: SKIP,
+                   scenes: SKIP, remix_actions: SKIP,
+                   is_output_temporary: false, hide_from_ui: false,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @script = script
+      @aspect_ratio = aspect_ratio unless aspect_ratio == SKIP
+      @visual_style = visual_style
+      @visual_pacing = visual_pacing unless visual_pacing == SKIP
+      @quality = quality unless quality == SKIP
+      @language = language unless language == SKIP
+      @voice_id = voice_id unless voice_id == SKIP
+      @voice_speed = voice_speed unless voice_speed == SKIP
+      @actor_entity_id = actor_entity_id unless actor_entity_id == SKIP
+      @avatar_quality = avatar_quality unless avatar_quality == SKIP
+      @featured_b_roll_file_ids = featured_b_roll_file_ids unless featured_b_roll_file_ids == SKIP
+      @workflow_agent_context = workflow_agent_context unless workflow_agent_context == SKIP
+      @scenes = scenes unless scenes == SKIP
+      @remix_actions = remix_actions unless remix_actions == SKIP
+      @is_output_temporary = is_output_temporary unless is_output_temporary == SKIP
+      @hide_from_ui = hide_from_ui unless hide_from_ui == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      script = hash.key?('script') ? hash['script'] : nil
+      visual_style = WorkflowVisualStyle.from_hash(hash['visualStyle']) if hash['visualStyle']
+      aspect_ratio = AspectRatio.from_hash(hash['aspectRatio']) if hash['aspectRatio']
+      visual_pacing = hash['visualPacing'] ||= VisualPacing::MEDIUM
+      quality = hash.key?('quality') ? hash['quality'] : SKIP
+      language = hash.key?('language') ? hash['language'] : SKIP
+      voice_id = hash.key?('voiceId') ? hash['voiceId'] : SKIP
+      voice_speed = hash.key?('voiceSpeed') ? hash['voiceSpeed'] : SKIP
+      actor_entity_id =
+        hash.key?('actorEntityId') ? hash['actorEntityId'] : SKIP
+      avatar_quality = hash.key?('avatarQuality') ? hash['avatarQuality'] : SKIP
+      featured_b_roll_file_ids =
+        hash.key?('featuredBRollFileIds') ? hash['featuredBRollFileIds'] : SKIP
+      workflow_agent_context =
+        hash.key?('workflowAgentContext') ? hash['workflowAgentContext'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      scenes = nil
+      unless hash['scenes'].nil?
+        scenes = []
+        hash['scenes'].each do |structure|
+          scenes << (SceneDescriptionRange.from_hash(structure) if structure)
+        end
+      end
+
+      scenes = SKIP unless hash.key?('scenes')
+      remix_actions = hash.key?('remixActions') ? APIHelper.deserialize_union_type(
+        UnionTypeLookUp.get(:RemixAction15), hash['remixActions']
+      ) : SKIP
+      is_output_temporary = hash['isOutputTemporary'] ||= false
+      hide_from_ui = hash['hideFromUi'] ||= false
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      ScriptToVideoRequest.new(script: script,
+                               visual_style: visual_style,
+                               aspect_ratio: aspect_ratio,
+                               visual_pacing: visual_pacing,
+                               quality: quality,
+                               language: language,
+                               voice_id: voice_id,
+                               voice_speed: voice_speed,
+                               actor_entity_id: actor_entity_id,
+                               avatar_quality: avatar_quality,
+                               featured_b_roll_file_ids: featured_b_roll_file_ids,
+                               workflow_agent_context: workflow_agent_context,
+                               scenes: scenes,
+                               remix_actions: remix_actions,
+                               is_output_temporary: is_output_temporary,
+                               hide_from_ui: hide_from_ui,
+                               additional_properties: additional_properties)
+    end
+
+    # Validates an instance of the object from a given value.
+    # @param [ScriptToVideoRequest | Hash] The value against the validation is performed.
+    def self.validate(value)
+      if value.instance_of? self
+        return (
+          APIHelper.valid_type?(value.script,
+                                ->(val) { val.instance_of? String }) and
+            APIHelper.valid_type?(value.visual_style,
+                                  ->(val) { WorkflowVisualStyle.validate(val) },
+                                  is_model_hash: true)
+        )
+      end
+
+      return false unless value.instance_of? Hash
+
+      (
+        APIHelper.valid_type?(value['script'],
+                              ->(val) { val.instance_of? String }) and
+          APIHelper.valid_type?(value['visualStyle'],
+                                ->(val) { WorkflowVisualStyle.validate(val) },
+                                is_model_hash: true)
+      )
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} script: #{@script}, aspect_ratio: #{@aspect_ratio}, visual_style:"\
+      " #{@visual_style}, visual_pacing: #{@visual_pacing}, quality: #{@quality}, language:"\
+      " #{@language}, voice_id: #{@voice_id}, voice_speed: #{@voice_speed}, actor_entity_id:"\
+      " #{@actor_entity_id}, avatar_quality: #{@avatar_quality}, featured_b_roll_file_ids:"\
+      " #{@featured_b_roll_file_ids}, workflow_agent_context: #{@workflow_agent_context}, scenes:"\
+      " #{@scenes}, remix_actions: #{@remix_actions}, is_output_temporary:"\
+      " #{@is_output_temporary}, hide_from_ui: #{@hide_from_ui}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} script: #{@script.inspect}, aspect_ratio: #{@aspect_ratio.inspect},"\
+      " visual_style: #{@visual_style.inspect}, visual_pacing: #{@visual_pacing.inspect}, quality:"\
+      " #{@quality.inspect}, language: #{@language.inspect}, voice_id: #{@voice_id.inspect},"\
+      " voice_speed: #{@voice_speed.inspect}, actor_entity_id: #{@actor_entity_id.inspect},"\
+      " avatar_quality: #{@avatar_quality.inspect}, featured_b_roll_file_ids:"\
+      " #{@featured_b_roll_file_ids.inspect}, workflow_agent_context:"\
+      " #{@workflow_agent_context.inspect}, scenes: #{@scenes.inspect}, remix_actions:"\
+      " #{@remix_actions.inspect}, is_output_temporary: #{@is_output_temporary.inspect},"\
+      " hide_from_ui: #{@hide_from_ui.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/videogen/models/search_files_request.rb

@@ -0,0 +1,96 @@
+# videogen
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Videogen
+  # SearchFilesRequest Model.
+  class SearchFilesRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Natural-language search query. The text is embedded and compared against
+    # file description vectors using cosine similarity.
+    # @return [String]
+    attr_accessor :query
+
+    # Number of results to return (1-100). Defaults to 10.
+    # @return [Integer]
+    attr_accessor :num_results
+
+    # When true, only files created by the calling API key's user are returned.
+    # When false (default), all files accessible to the team are included.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :self_only
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['query'] = 'query'
+      @_hash['num_results'] = 'numResults'
+      @_hash['self_only'] = 'selfOnly'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        num_results
+        self_only
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(query:, num_results: 10, self_only: false,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @query = query
+      @num_results = num_results unless num_results == SKIP
+      @self_only = self_only unless self_only == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      query = hash.key?('query') ? hash['query'] : nil
+      num_results = hash['numResults'] ||= 10
+      self_only = hash['selfOnly'] ||= false
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      SearchFilesRequest.new(query: query,
+                             num_results: num_results,
+                             self_only: self_only,
+                             additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} query: #{@query}, num_results: #{@num_results}, self_only: #{@self_only},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} query: #{@query.inspect}, num_results: #{@num_results.inspect}, self_only:"\
+      " #{@self_only.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/videogen/models/search_files_response.rb

@@ -0,0 +1,82 @@
+# videogen
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Videogen
+  # SearchFilesResponse Model.
+  class SearchFilesResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # TODO: Write general description for this method
+    # @return [Array[SearchFilesResult]]
+    attr_accessor :results
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['results'] = 'results'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(results:, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @results = results
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      # Parameter is an array, so we need to iterate through it
+      results = nil
+      unless hash['results'].nil?
+        results = []
+        hash['results'].each do |structure|
+          results << (SearchFilesResult.from_hash(structure) if structure)
+        end
+      end
+
+      results = nil unless hash.key?('results')
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      SearchFilesResponse.new(results: results,
+                              additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} results: #{@results}, additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} results: #{@results.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end