openai 0.57.0 → 0.59.0

data/rbi/openai/models/conversations/message.rbi

@@ -33,6 +33,17 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
+        sig do
+          returns(
+            T.nilable(OpenAI::Conversations::Message::Phase::TaggedSymbol)
+          )
+        end
+        attr_accessor :phase
+
         # A message to or from the model.
         sig do
           params(
@@ -53,6 +64,7 @@ module OpenAI
               ],
             role: OpenAI::Conversations::Message::Role::OrSymbol,
             status: OpenAI::Conversations::Message::Status::OrSymbol,
+            phase: T.nilable(OpenAI::Conversations::Message::Phase::OrSymbol),
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -67,6 +79,11 @@ module OpenAI
           # The status of item. One of `in_progress`, `completed`, or `incomplete`.
           # Populated when items are returned via API.
           status:,
+          # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+          # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+          # sending follow-up requests, preserve and resend phase on all assistant messages
+          # — dropping it can degrade performance. Not used for user messages.
+          phase: nil,
           # The type of the message. Always set to `message`.
           type: :message
         )
@@ -80,7 +97,9 @@ module OpenAI
                 T::Array[OpenAI::Conversations::Message::Content::Variants],
               role: OpenAI::Conversations::Message::Role::TaggedSymbol,
               status: OpenAI::Conversations::Message::Status::TaggedSymbol,
-              type: Symbol
+              type: Symbol,
+              phase:
+                T.nilable(OpenAI::Conversations::Message::Phase::TaggedSymbol)
             }
           )
         end
@@ -226,6 +245,39 @@ module OpenAI
           def self.values
           end
         end
+
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Conversations::Message::Phase)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          COMMENTARY =
+            T.let(
+              :commentary,
+              OpenAI::Conversations::Message::Phase::TaggedSymbol
+            )
+          FINAL_ANSWER =
+            T.let(
+              :final_answer,
+              OpenAI::Conversations::Message::Phase::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Conversations::Message::Phase::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/models/oauth_error_code.rbi

@@ -0,0 +1,24 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module OAuthErrorCode
+      extend OpenAI::Internal::Type::Union
+
+      Variants =
+        T.type_alias { T.any(OpenAI::OAuthErrorCode::TaggedSymbol, String) }
+
+      sig { override.returns(T::Array[OpenAI::OAuthErrorCode::Variants]) }
+      def self.variants
+      end
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::OAuthErrorCode) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      INVALID_GRANT =
+        T.let(:invalid_grant, OpenAI::OAuthErrorCode::TaggedSymbol)
+      INVALID_SUBJECT_TOKEN =
+        T.let(:invalid_subject_token, OpenAI::OAuthErrorCode::TaggedSymbol)
+    end
+  end
+end

data/rbi/openai/models/realtime/realtime_session_create_request.rbi

@@ -193,8 +193,9 @@ module OpenAI
         attr_writer :tools
 
         # Realtime API can write session traces to the
-        # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-        # tracing is enabled for a session, the configuration cannot be modified.
+        # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+        # disable tracing. Once tracing is enabled for a session, the configuration cannot
+        # be modified.
         #
         # `auto` will create a trace for the session with default values for the workflow
         # name, group id, and metadata.
@@ -339,8 +340,9 @@ module OpenAI
           # Tools available to the model.
           tools: nil,
           # Realtime API can write session traces to the
-          # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-          # tracing is enabled for a session, the configuration cannot be modified.
+          # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+          # disable tracing. Once tracing is enabled for a session, the configuration cannot
+          # be modified.
           #
           # `auto` will create a trace for the session with default values for the workflow
           # name, group id, and metadata.

data/rbi/openai/models/realtime/realtime_session_create_response.rbi

@@ -209,8 +209,9 @@ module OpenAI
         attr_writer :tools
 
         # Realtime API can write session traces to the
-        # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-        # tracing is enabled for a session, the configuration cannot be modified.
+        # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+        # disable tracing. Once tracing is enabled for a session, the configuration cannot
+        # be modified.
         #
         # `auto` will create a trace for the session with default values for the workflow
         # name, group id, and metadata.
@@ -351,8 +352,9 @@ module OpenAI
           # Tools available to the model.
           tools: nil,
           # Realtime API can write session traces to the
-          # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-          # tracing is enabled for a session, the configuration cannot be modified.
+          # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+          # disable tracing. Once tracing is enabled for a session, the configuration cannot
+          # be modified.
           #
           # `auto` will create a trace for the session with default values for the workflow
           # name, group id, and metadata.
@@ -2091,8 +2093,9 @@ module OpenAI
         end
 
         # Realtime API can write session traces to the
-        # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-        # tracing is enabled for a session, the configuration cannot be modified.
+        # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+        # disable tracing. Once tracing is enabled for a session, the configuration cannot
+        # be modified.
         #
         # `auto` will create a trace for the session with default values for the workflow
         # name, group id, and metadata.

data/rbi/openai/models/realtime/realtime_tracing_config.rbi

@@ -4,8 +4,9 @@ module OpenAI
   module Models
     module Realtime
       # Realtime API can write session traces to the
-      # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-      # tracing is enabled for a session, the configuration cannot be modified.
+      # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+      # disable tracing. Once tracing is enabled for a session, the configuration cannot
+      # be modified.
       #
       # `auto` will create a trace for the session with default values for the workflow
       # name, group id, and metadata.

data/rbi/openai/models/responses/response_input_file.rbi

@@ -16,6 +16,23 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The detail level of the file to be sent to the model. Use `low` for the default
+        # rendering behavior, or `high` to render the file at higher quality. Defaults to
+        # `low`.
+        sig do
+          returns(
+            T.nilable(OpenAI::Responses::ResponseInputFile::Detail::OrSymbol)
+          )
+        end
+        attr_reader :detail
+
+        sig do
+          params(
+            detail: OpenAI::Responses::ResponseInputFile::Detail::OrSymbol
+          ).void
+        end
+        attr_writer :detail
+
         # The content of the file to be sent to the model.
         sig { returns(T.nilable(String)) }
         attr_reader :file_data
@@ -44,6 +61,7 @@ module OpenAI
         # A file input to the model.
         sig do
           params(
+            detail: OpenAI::Responses::ResponseInputFile::Detail::OrSymbol,
             file_data: String,
             file_id: T.nilable(String),
             file_url: String,
@@ -52,6 +70,10 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # The detail level of the file to be sent to the model. Use `low` for the default
+          # rendering behavior, or `high` to render the file at higher quality. Defaults to
+          # `low`.
+          detail: nil,
           # The content of the file to be sent to the model.
           file_data: nil,
           # The ID of the file to be sent to the model.
@@ -69,6 +91,7 @@ module OpenAI
           override.returns(
             {
               type: Symbol,
+              detail: OpenAI::Responses::ResponseInputFile::Detail::OrSymbol,
               file_data: String,
               file_id: T.nilable(String),
               file_url: String,
@@ -78,6 +101,40 @@ module OpenAI
         end
         def to_hash
         end
+
+        # The detail level of the file to be sent to the model. Use `low` for the default
+        # rendering behavior, or `high` to render the file at higher quality. Defaults to
+        # `low`.
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::ResponseInputFile::Detail)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LOW =
+            T.let(
+              :low,
+              OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+            )
+          HIGH =
+            T.let(
+              :high,
+              OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_file_content.rbi

@@ -16,6 +16,26 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The detail level of the file to be sent to the model. Use `low` for the default
+        # rendering behavior, or `high` to render the file at higher quality. Defaults to
+        # `low`.
+        sig do
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol
+            )
+          )
+        end
+        attr_reader :detail
+
+        sig do
+          params(
+            detail:
+              OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol
+          ).void
+        end
+        attr_writer :detail
+
         # The base64-encoded data of the file to be sent to the model.
         sig { returns(T.nilable(String)) }
         attr_accessor :file_data
@@ -35,6 +55,8 @@ module OpenAI
         # A file input to the model.
         sig do
           params(
+            detail:
+              OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol,
             file_data: T.nilable(String),
             file_id: T.nilable(String),
             file_url: T.nilable(String),
@@ -43,6 +65,10 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # The detail level of the file to be sent to the model. Use `low` for the default
+          # rendering behavior, or `high` to render the file at higher quality. Defaults to
+          # `low`.
+          detail: nil,
           # The base64-encoded data of the file to be sent to the model.
           file_data: nil,
           # The ID of the file to be sent to the model.
@@ -60,6 +86,8 @@ module OpenAI
           override.returns(
             {
               type: Symbol,
+              detail:
+                OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol,
               file_data: T.nilable(String),
               file_id: T.nilable(String),
               file_url: T.nilable(String),
@@ -69,6 +97,40 @@ module OpenAI
         end
         def to_hash
         end
+
+        # The detail level of the file to be sent to the model. Use `low` for the default
+        # rendering behavior, or `high` to render the file at higher quality. Defaults to
+        # `low`.
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::ResponseInputFileContent::Detail)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LOW =
+            T.let(
+              :low,
+              OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+            )
+          HIGH =
+            T.let(
+              :high,
+              OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/models/vector_stores/file_batch_create_params.rbi

@@ -63,8 +63,9 @@ module OpenAI
         # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
         # the vector store should use. Useful for tools like `file_search` that can access
         # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-        # to all files in the batch. The maximum batch size is 2000 files. Mutually
-        # exclusive with `files`.
+        # to all files in the batch. The maximum batch size is 2000 files. This endpoint
+        # is recommended for multi-file ingestion and helps reduce per-vector-store write
+        # request pressure. Mutually exclusive with `files`.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :file_ids
 
@@ -74,8 +75,9 @@ module OpenAI
         # A list of objects that each include a `file_id` plus optional `attributes` or
         # `chunking_strategy`. Use this when you need to override metadata for specific
         # files. The global `attributes` or `chunking_strategy` will be ignored and must
-        # be specified for each file. The maximum batch size is 2000 files. Mutually
-        # exclusive with `file_ids`.
+        # be specified for each file. The maximum batch size is 2000 files. This endpoint
+        # is recommended for multi-file ingestion and helps reduce per-vector-store write
+        # request pressure. Mutually exclusive with `file_ids`.
         sig do
           returns(
             T.nilable(
@@ -132,14 +134,16 @@ module OpenAI
           # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
           # the vector store should use. Useful for tools like `file_search` that can access
           # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-          # to all files in the batch. The maximum batch size is 2000 files. Mutually
-          # exclusive with `files`.
+          # to all files in the batch. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `files`.
           file_ids: nil,
           # A list of objects that each include a `file_id` plus optional `attributes` or
           # `chunking_strategy`. Use this when you need to override metadata for specific
           # files. The global `attributes` or `chunking_strategy` will be ignored and must
-          # be specified for each file. The maximum batch size is 2000 files. Mutually
-          # exclusive with `file_ids`.
+          # be specified for each file. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `file_ids`.
           files: nil,
           request_options: {}
         )
@@ -198,7 +202,9 @@ module OpenAI
 
           # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           # vector store should use. Useful for tools like `file_search` that can access
-          # files.
+          # files. For multi-file ingestion, we recommend
+          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # to minimize per-vector-store write requests.
           sig { returns(String) }
           attr_accessor :file_id
 
@@ -264,7 +270,9 @@ module OpenAI
           def self.new(
             # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
             # vector store should use. Useful for tools like `file_search` that can access
-            # files.
+            # files. For multi-file ingestion, we recommend
+            # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+            # to minimize per-vector-store write requests.
             file_id:,
             # Set of 16 key-value pairs that can be attached to an object. This can be useful
             # for storing additional information about the object in a structured format, and

data/rbi/openai/models/vector_stores/file_create_params.rbi

@@ -20,7 +20,9 @@ module OpenAI
 
         # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
         # vector store should use. Useful for tools like `file_search` that can access
-        # files.
+        # files. For multi-file ingestion, we recommend
+        # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+        # to minimize per-vector-store write requests.
         sig { returns(String) }
         attr_accessor :file_id
 
@@ -89,7 +91,9 @@ module OpenAI
           vector_store_id:,
           # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           # vector store should use. Useful for tools like `file_search` that can access
-          # files.
+          # files. For multi-file ingestion, we recommend
+          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # to minimize per-vector-store write requests.
           file_id:,
           # Set of 16 key-value pairs that can be attached to an object. This can be useful
           # for storing additional information about the object in a structured format, and

data/rbi/openai/models.rbi

@@ -169,6 +169,8 @@ module OpenAI
 
   ModerationTextInput = OpenAI::Models::ModerationTextInput
 
+  OAuthErrorCode = OpenAI::Models::OAuthErrorCode
+
   OtherFileChunkingStrategyObject =
     OpenAI::Models::OtherFileChunkingStrategyObject
 

data/rbi/openai/resources/realtime/calls.rbi

@@ -99,8 +99,9 @@ module OpenAI
           # Tools available to the model.
           tools: nil,
           # Realtime API can write session traces to the
-          # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-          # tracing is enabled for a session, the configuration cannot be modified.
+          # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+          # disable tracing. Once tracing is enabled for a session, the configuration cannot
+          # be modified.
           #
           # `auto` will create a trace for the session with default values for the workflow
           # name, group id, and metadata.

data/rbi/openai/resources/vector_stores/file_batches.rbi

@@ -43,14 +43,16 @@ module OpenAI
           # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
           # the vector store should use. Useful for tools like `file_search` that can access
           # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-          # to all files in the batch. The maximum batch size is 2000 files. Mutually
-          # exclusive with `files`.
+          # to all files in the batch. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `files`.
           file_ids: nil,
           # A list of objects that each include a `file_id` plus optional `attributes` or
           # `chunking_strategy`. Use this when you need to override metadata for specific
           # files. The global `attributes` or `chunking_strategy` will be ignored and must
-          # be specified for each file. The maximum batch size is 2000 files. Mutually
-          # exclusive with `file_ids`.
+          # be specified for each file. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `file_ids`.
           files: nil,
           request_options: {}
         )

data/rbi/openai/resources/vector_stores/files.rbi

@@ -31,7 +31,9 @@ module OpenAI
           vector_store_id,
           # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           # vector store should use. Useful for tools like `file_search` that can access
-          # files.
+          # files. For multi-file ingestion, we recommend
+          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # to minimize per-vector-store write requests.
           file_id:,
           # Set of 16 key-value pairs that can be attached to an object. This can be useful
           # for storing additional information about the object in a structured format, and

data/sig/openai/internal/util.rbs

@@ -45,8 +45,12 @@ module OpenAI
         -> top?
       } -> top?
 
+      RFC_3986_NOT_PCHARS: Regexp
+
       def self?.uri_origin: (URI::Generic uri) -> String
 
+      def self?.encode_path: (String | Integer path) -> String
+
       def self?.interpolate_path: (String | ::Array[String] path) -> String
 
       def self?.decode_query: (String? query) -> ::Hash[String, ::Array[String]]

data/sig/openai/models/conversations/message.rbs

@@ -7,7 +7,8 @@ module OpenAI
           content: ::Array[OpenAI::Models::Conversations::Message::content],
           role: OpenAI::Models::Conversations::Message::role,
           status: OpenAI::Models::Conversations::Message::status,
-          type: :message
+          type: :message,
+          phase: OpenAI::Models::Conversations::Message::phase?
         }
 
       class Message < OpenAI::Internal::Type::BaseModel
@@ -21,11 +22,14 @@ module OpenAI
 
         attr_accessor type: :message
 
+        attr_accessor phase: OpenAI::Models::Conversations::Message::phase?
+
         def initialize: (
           id: String,
           content: ::Array[OpenAI::Models::Conversations::Message::content],
           role: OpenAI::Models::Conversations::Message::role,
           status: OpenAI::Models::Conversations::Message::status,
+          ?phase: OpenAI::Models::Conversations::Message::phase?,
           ?type: :message
         ) -> void
 
@@ -34,7 +38,8 @@ module OpenAI
           content: ::Array[OpenAI::Models::Conversations::Message::content],
           role: OpenAI::Models::Conversations::Message::role,
           status: OpenAI::Models::Conversations::Message::status,
-          type: :message
+          type: :message,
+          phase: OpenAI::Models::Conversations::Message::phase?
         }
 
         type content =
@@ -102,6 +107,17 @@ module OpenAI
 
           def self?.values: -> ::Array[OpenAI::Models::Conversations::Message::status]
         end
+
+        type phase = :commentary | :final_answer
+
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY: :commentary
+          FINAL_ANSWER: :final_answer
+
+          def self?.values: -> ::Array[OpenAI::Models::Conversations::Message::phase]
+        end
       end
     end
   end

data/sig/openai/models/oauth_error_code.rbs

@@ -0,0 +1,14 @@
+module OpenAI
+  module Models
+    type oauth_error_code = :invalid_grant | :invalid_subject_token | String
+
+    module OAuthErrorCode
+      extend OpenAI::Internal::Type::Union
+
+      def self?.variants: -> ::Array[OpenAI::Models::oauth_error_code]
+
+      INVALID_GRANT: :invalid_grant
+      INVALID_SUBJECT_TOKEN: :invalid_subject_token
+    end
+  end
+end

data/sig/openai/models/responses/response_input_file.rbs

@@ -4,6 +4,7 @@ module OpenAI
       type response_input_file =
         {
           type: :input_file,
+          detail: OpenAI::Models::Responses::ResponseInputFile::detail,
           file_data: String,
           file_id: String?,
           file_url: String,
@@ -13,6 +14,12 @@ module OpenAI
       class ResponseInputFile < OpenAI::Internal::Type::BaseModel
         attr_accessor type: :input_file
 
+        attr_reader detail: OpenAI::Models::Responses::ResponseInputFile::detail?
+
+        def detail=: (
+          OpenAI::Models::Responses::ResponseInputFile::detail
+        ) -> OpenAI::Models::Responses::ResponseInputFile::detail
+
         attr_reader file_data: String?
 
         def file_data=: (String) -> String
@@ -28,6 +35,7 @@ module OpenAI
         def filename=: (String) -> String
 
         def initialize: (
+          ?detail: OpenAI::Models::Responses::ResponseInputFile::detail,
           ?file_data: String,
           ?file_id: String?,
           ?file_url: String,
@@ -37,11 +45,23 @@ module OpenAI
 
         def to_hash: -> {
           type: :input_file,
+          detail: OpenAI::Models::Responses::ResponseInputFile::detail,
           file_data: String,
           file_id: String?,
           file_url: String,
           filename: String
         }
+
+        type detail = :low | :high
+
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          LOW: :low
+          HIGH: :high
+
+          def self?.values: -> ::Array[OpenAI::Models::Responses::ResponseInputFile::detail]
+        end
       end
     end
   end