openai 0.16.0 → 0.17.0

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -225,12 +225,11 @@ module OpenAI
         sig { params(prompt_cache_key: String).void }
         attr_writer :prompt_cache_key
 
-        # **o-series models only**
-        #
         # Constrains effort on reasoning for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-        # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-        # result in faster responses and fewer tokens used on reasoning in a response.
+        # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+        # effort can result in faster responses and fewer tokens used on reasoning in a
+        # response.
         sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
         attr_accessor :reasoning_effort
 
@@ -368,7 +367,9 @@ module OpenAI
             T.nilable(
               T.any(
                 OpenAI::Chat::ChatCompletionToolChoiceOption::Auto::OrSymbol,
-                OpenAI::Chat::ChatCompletionNamedToolChoice
+                OpenAI::Chat::ChatCompletionAllowedToolChoice,
+                OpenAI::Chat::ChatCompletionNamedToolChoice,
+                OpenAI::Chat::ChatCompletionNamedToolChoiceCustom
               )
             )
           )
@@ -380,16 +381,29 @@ module OpenAI
             tool_choice:
               T.any(
                 OpenAI::Chat::ChatCompletionToolChoiceOption::Auto::OrSymbol,
-                OpenAI::Chat::ChatCompletionNamedToolChoice::OrHash
+                OpenAI::Chat::ChatCompletionAllowedToolChoice::OrHash,
+                OpenAI::Chat::ChatCompletionNamedToolChoice::OrHash,
+                OpenAI::Chat::ChatCompletionNamedToolChoiceCustom::OrHash
               )
           ).void
         end
         attr_writer :tool_choice
 
-        # A list of tools the model may call. Currently, only functions are supported as a
-        # tool. Use this to provide a list of functions the model may generate JSON inputs
-        # for. A max of 128 functions are supported.
-        sig { returns(T.nilable(T::Array[OpenAI::Chat::ChatCompletionTool])) }
+        # A list of tools the model may call. You can provide either
+        # [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+        # or [function tools](https://platform.openai.com/docs/guides/function-calling).
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                T.any(
+                  OpenAI::Chat::ChatCompletionFunctionTool,
+                  OpenAI::Chat::ChatCompletionCustomTool
+                )
+              ]
+            )
+          )
+        end
         attr_reader :tools
 
         sig do
@@ -397,8 +411,9 @@ module OpenAI
             tools:
               T::Array[
                 T.any(
-                  OpenAI::Chat::ChatCompletionTool::OrHash,
-                  OpenAI::StructuredOutput::JsonSchemaConverter
+                  OpenAI::StructuredOutput::JsonSchemaConverter,
+                  OpenAI::Chat::ChatCompletionFunctionTool::OrHash,
+                  OpenAI::Chat::ChatCompletionCustomTool::OrHash
                 )
               ]
           ).void
@@ -430,6 +445,16 @@ module OpenAI
         sig { params(user: String).void }
         attr_writer :user
 
+        # Constrains the verbosity of the model's response. Lower values will result in
+        # more concise responses, while higher values will result in more verbose
+        # responses. Currently supported values are `low`, `medium`, and `high`.
+        sig do
+          returns(
+            T.nilable(OpenAI::Chat::CompletionCreateParams::Verbosity::OrSymbol)
+          )
+        end
+        attr_accessor :verbosity
+
         # This tool searches the web for relevant results to use in a response. Learn more
         # about the
         # [web search tool](https://platform.openai.com/docs/guides/tools-web-search?api-mode=chat).
@@ -511,18 +536,25 @@ module OpenAI
             tool_choice:
               T.any(
                 OpenAI::Chat::ChatCompletionToolChoiceOption::Auto::OrSymbol,
-                OpenAI::Chat::ChatCompletionNamedToolChoice::OrHash
+                OpenAI::Chat::ChatCompletionAllowedToolChoice::OrHash,
+                OpenAI::Chat::ChatCompletionNamedToolChoice::OrHash,
+                OpenAI::Chat::ChatCompletionNamedToolChoiceCustom::OrHash
               ),
             tools:
               T::Array[
                 T.any(
-                  OpenAI::Chat::ChatCompletionTool::OrHash,
-                  OpenAI::StructuredOutput::JsonSchemaConverter
+                  OpenAI::StructuredOutput::JsonSchemaConverter,
+                  OpenAI::Chat::ChatCompletionFunctionTool::OrHash,
+                  OpenAI::Chat::ChatCompletionCustomTool::OrHash
                 )
               ],
             top_logprobs: T.nilable(Integer),
             top_p: T.nilable(Float),
             user: String,
+            verbosity:
+              T.nilable(
+                OpenAI::Chat::CompletionCreateParams::Verbosity::OrSymbol
+              ),
             web_search_options:
               OpenAI::Chat::CompletionCreateParams::WebSearchOptions::OrHash,
             request_options: OpenAI::RequestOptions::OrHash
@@ -631,12 +663,11 @@ module OpenAI
           # hit rates. Replaces the `user` field.
           # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           prompt_cache_key: nil,
-          # **o-series models only**
-          #
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-          # result in faster responses and fewer tokens used on reasoning in a response.
+          # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+          # effort can result in faster responses and fewer tokens used on reasoning in a
+          # response.
           reasoning_effort: nil,
           # An object specifying the format that the model must output.
           #
@@ -707,9 +738,9 @@ module OpenAI
           # `none` is the default when no tools are present. `auto` is the default if tools
           # are present.
           tool_choice: nil,
-          # A list of tools the model may call. Currently, only functions are supported as a
-          # tool. Use this to provide a list of functions the model may generate JSON inputs
-          # for. A max of 128 functions are supported.
+          # A list of tools the model may call. You can provide either
+          # [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+          # or [function tools](https://platform.openai.com/docs/guides/function-calling).
           tools: nil,
           # An integer between 0 and 20 specifying the number of most likely tokens to
           # return at each token position, each with an associated log probability.
@@ -727,6 +758,10 @@ module OpenAI
           # similar requests and to help OpenAI detect and prevent abuse.
           # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           user: nil,
+          # Constrains the verbosity of the model's response. Lower values will result in
+          # more concise responses, while higher values will result in more verbose
+          # responses. Currently supported values are `low`, `medium`, and `high`.
+          verbosity: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the
           # [web search tool](https://platform.openai.com/docs/guides/tools-web-search?api-mode=chat).
@@ -798,18 +833,25 @@ module OpenAI
               tool_choice:
                 T.any(
                   OpenAI::Chat::ChatCompletionToolChoiceOption::Auto::OrSymbol,
-                  OpenAI::Chat::ChatCompletionNamedToolChoice
+                  OpenAI::Chat::ChatCompletionAllowedToolChoice,
+                  OpenAI::Chat::ChatCompletionNamedToolChoice,
+                  OpenAI::Chat::ChatCompletionNamedToolChoiceCustom
                 ),
               tools:
                 T::Array[
                   T.any(
-                    OpenAI::Chat::ChatCompletionTool,
-                    OpenAI::StructuredOutput::JsonSchemaConverter
+                    OpenAI::StructuredOutput::JsonSchemaConverter,
+                    OpenAI::Chat::ChatCompletionFunctionTool,
+                    OpenAI::Chat::ChatCompletionCustomTool
                   )
                 ],
               top_logprobs: T.nilable(Integer),
               top_p: T.nilable(Float),
               user: String,
+              verbosity:
+                T.nilable(
+                  OpenAI::Chat::CompletionCreateParams::Verbosity::OrSymbol
+                ),
               web_search_options:
                 OpenAI::Chat::CompletionCreateParams::WebSearchOptions,
               request_options: OpenAI::RequestOptions
@@ -1137,6 +1179,45 @@ module OpenAI
             )
         end
 
+        # Constrains the verbosity of the model's response. Lower values will result in
+        # more concise responses, while higher values will result in more verbose
+        # responses. Currently supported values are `low`, `medium`, and `high`.
+        module Verbosity
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Chat::CompletionCreateParams::Verbosity)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LOW =
+            T.let(
+              :low,
+              OpenAI::Chat::CompletionCreateParams::Verbosity::TaggedSymbol
+            )
+          MEDIUM =
+            T.let(
+              :medium,
+              OpenAI::Chat::CompletionCreateParams::Verbosity::TaggedSymbol
+            )
+          HIGH =
+            T.let(
+              :high,
+              OpenAI::Chat::CompletionCreateParams::Verbosity::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Chat::CompletionCreateParams::Verbosity::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         class WebSearchOptions < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/openai/models/chat_model.rbi

@@ -8,6 +8,17 @@ module OpenAI
       TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ChatModel) }
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+      GPT_5 = T.let(:"gpt-5", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_MINI = T.let(:"gpt-5-mini", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_NANO = T.let(:"gpt-5-nano", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_2025_08_07 =
+        T.let(:"gpt-5-2025-08-07", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_MINI_2025_08_07 =
+        T.let(:"gpt-5-mini-2025-08-07", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_NANO_2025_08_07 =
+        T.let(:"gpt-5-nano-2025-08-07", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_CHAT_LATEST =
+        T.let(:"gpt-5-chat-latest", OpenAI::ChatModel::TaggedSymbol)
       GPT_4_1 = T.let(:"gpt-4.1", OpenAI::ChatModel::TaggedSymbol)
       GPT_4_1_MINI = T.let(:"gpt-4.1-mini", OpenAI::ChatModel::TaggedSymbol)
       GPT_4_1_NANO = T.let(:"gpt-4.1-nano", OpenAI::ChatModel::TaggedSymbol)

data/rbi/openai/models/custom_tool_input_format.rbi

@@ -0,0 +1,136 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    # The input format for the custom tool. Default is unconstrained text.
+    module CustomToolInputFormat
+      extend OpenAI::Internal::Type::Union
+
+      Variants =
+        T.type_alias do
+          T.any(
+            OpenAI::CustomToolInputFormat::Text,
+            OpenAI::CustomToolInputFormat::Grammar
+          )
+        end
+
+      class Text < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::CustomToolInputFormat::Text,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Unconstrained text format. Always `text`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Unconstrained free-form text.
+        sig { params(type: Symbol).returns(T.attached_class) }
+        def self.new(
+          # Unconstrained text format. Always `text`.
+          type: :text
+        )
+        end
+
+        sig { override.returns({ type: Symbol }) }
+        def to_hash
+        end
+      end
+
+      class Grammar < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::CustomToolInputFormat::Grammar,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The grammar definition.
+        sig { returns(String) }
+        attr_accessor :definition
+
+        # The syntax of the grammar definition. One of `lark` or `regex`.
+        sig do
+          returns(OpenAI::CustomToolInputFormat::Grammar::Syntax::OrSymbol)
+        end
+        attr_accessor :syntax
+
+        # Grammar format. Always `grammar`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # A grammar defined by the user.
+        sig do
+          params(
+            definition: String,
+            syntax: OpenAI::CustomToolInputFormat::Grammar::Syntax::OrSymbol,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The grammar definition.
+          definition:,
+          # The syntax of the grammar definition. One of `lark` or `regex`.
+          syntax:,
+          # Grammar format. Always `grammar`.
+          type: :grammar
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              definition: String,
+              syntax: OpenAI::CustomToolInputFormat::Grammar::Syntax::OrSymbol,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The syntax of the grammar definition. One of `lark` or `regex`.
+        module Syntax
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::CustomToolInputFormat::Grammar::Syntax)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LARK =
+            T.let(
+              :lark,
+              OpenAI::CustomToolInputFormat::Grammar::Syntax::TaggedSymbol
+            )
+          REGEX =
+            T.let(
+              :regex,
+              OpenAI::CustomToolInputFormat::Grammar::Syntax::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::CustomToolInputFormat::Grammar::Syntax::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      sig do
+        override.returns(T::Array[OpenAI::CustomToolInputFormat::Variants])
+      end
+      def self.variants
+      end
+    end
+  end
+end

data/rbi/openai/models/evals/create_eval_completions_run_data_source.rbi

@@ -935,12 +935,16 @@ module OpenAI
           # A list of tools the model may call. Currently, only functions are supported as a
           # tool. Use this to provide a list of functions the model may generate JSON inputs
           # for. A max of 128 functions are supported.
-          sig { returns(T.nilable(T::Array[OpenAI::Chat::ChatCompletionTool])) }
+          sig do
+            returns(
+              T.nilable(T::Array[OpenAI::Chat::ChatCompletionFunctionTool])
+            )
+          end
           attr_reader :tools
 
           sig do
             params(
-              tools: T::Array[OpenAI::Chat::ChatCompletionTool::OrHash]
+              tools: T::Array[OpenAI::Chat::ChatCompletionFunctionTool::OrHash]
             ).void
           end
           attr_writer :tools
@@ -963,7 +967,7 @@ module OpenAI
                 ),
               seed: Integer,
               temperature: Float,
-              tools: T::Array[OpenAI::Chat::ChatCompletionTool::OrHash],
+              tools: T::Array[OpenAI::Chat::ChatCompletionFunctionTool::OrHash],
               top_p: Float
             ).returns(T.attached_class)
           end
@@ -1006,7 +1010,7 @@ module OpenAI
                   ),
                 seed: Integer,
                 temperature: Float,
-                tools: T::Array[OpenAI::Chat::ChatCompletionTool],
+                tools: T::Array[OpenAI::Chat::ChatCompletionFunctionTool],
                 top_p: Float
               }
             )

data/rbi/openai/models/evals/run_cancel_response.rbi

@@ -1174,6 +1174,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ]
@@ -1205,6 +1206,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ],

data/rbi/openai/models/evals/run_create_params.rbi

@@ -1125,6 +1125,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter,
                         OpenAI::Responses::Tool::ImageGeneration,
                         OpenAI::Responses::Tool::LocalShell,
+                        OpenAI::Responses::CustomTool,
                         OpenAI::Responses::WebSearchTool
                       )
                     ]
@@ -1145,6 +1146,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ]
@@ -1176,6 +1178,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ],
@@ -1233,6 +1236,7 @@ module OpenAI
                           OpenAI::Responses::Tool::CodeInterpreter,
                           OpenAI::Responses::Tool::ImageGeneration,
                           OpenAI::Responses::Tool::LocalShell,
+                          OpenAI::Responses::CustomTool,
                           OpenAI::Responses::WebSearchTool
                         )
                       ],

data/rbi/openai/models/evals/run_create_response.rbi

@@ -1174,6 +1174,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ]
@@ -1205,6 +1206,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ],

data/rbi/openai/models/evals/run_list_response.rbi

@@ -1170,6 +1170,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ]
@@ -1201,6 +1202,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ],

data/rbi/openai/models/evals/run_retrieve_response.rbi

@@ -1176,6 +1176,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ]
@@ -1207,6 +1208,7 @@ module OpenAI
                         OpenAI::Responses::Tool::CodeInterpreter::OrHash,
                         OpenAI::Responses::Tool::ImageGeneration::OrHash,
                         OpenAI::Responses::Tool::LocalShell::OrHash,
+                        OpenAI::Responses::CustomTool::OrHash,
                         OpenAI::Responses::WebSearchTool::OrHash
                       )
                     ],

data/rbi/openai/models/reasoning.rbi

@@ -6,12 +6,11 @@ module OpenAI
       OrHash =
         T.type_alias { T.any(OpenAI::Reasoning, OpenAI::Internal::AnyHash) }
 
-      # **o-series models only**
-      #
       # Constrains effort on reasoning for
       # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-      # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-      # result in faster responses and fewer tokens used on reasoning in a response.
+      # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+      # effort can result in faster responses and fewer tokens used on reasoning in a
+      # response.
       sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
       attr_accessor :effort
 
@@ -42,12 +41,11 @@ module OpenAI
         ).returns(T.attached_class)
       end
       def self.new(
-        # **o-series models only**
-        #
         # Constrains effort on reasoning for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-        # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-        # result in faster responses and fewer tokens used on reasoning in a response.
+        # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+        # effort can result in faster responses and fewer tokens used on reasoning in a
+        # response.
         effort: nil,
         # **Deprecated:** use `summary` instead.
         #

data/rbi/openai/models/reasoning_effort.rbi

@@ -2,18 +2,18 @@
 
 module OpenAI
   module Models
-    # **o-series models only**
-    #
     # Constrains effort on reasoning for
     # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-    # supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
-    # result in faster responses and fewer tokens used on reasoning in a response.
+    # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+    # effort can result in faster responses and fewer tokens used on reasoning in a
+    # response.
     module ReasoningEffort
       extend OpenAI::Internal::Type::Enum
 
       TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ReasoningEffort) }
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+      MINIMAL = T.let(:minimal, OpenAI::ReasoningEffort::TaggedSymbol)
       LOW = T.let(:low, OpenAI::ReasoningEffort::TaggedSymbol)
       MEDIUM = T.let(:medium, OpenAI::ReasoningEffort::TaggedSymbol)
       HIGH = T.let(:high, OpenAI::ReasoningEffort::TaggedSymbol)

data/rbi/openai/models/response_format_text_grammar.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    class ResponseFormatTextGrammar < OpenAI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(OpenAI::ResponseFormatTextGrammar, OpenAI::Internal::AnyHash)
+        end
+
+      # The custom grammar for the model to follow.
+      sig { returns(String) }
+      attr_accessor :grammar
+
+      # The type of response format being defined. Always `grammar`.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      # A custom grammar for the model to follow when generating text. Learn more in the
+      # [custom grammars guide](https://platform.openai.com/docs/guides/custom-grammars).
+      sig { params(grammar: String, type: Symbol).returns(T.attached_class) }
+      def self.new(
+        # The custom grammar for the model to follow.
+        grammar:,
+        # The type of response format being defined. Always `grammar`.
+        type: :grammar
+      )
+      end
+
+      sig { override.returns({ grammar: String, type: Symbol }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/openai/models/response_format_text_python.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    class ResponseFormatTextPython < OpenAI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(OpenAI::ResponseFormatTextPython, OpenAI::Internal::AnyHash)
+        end
+
+      # The type of response format being defined. Always `python`.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      # Configure the model to generate valid Python code. See the
+      # [custom grammars guide](https://platform.openai.com/docs/guides/custom-grammars)
+      # for more details.
+      sig { params(type: Symbol).returns(T.attached_class) }
+      def self.new(
+        # The type of response format being defined. Always `python`.
+        type: :python
+      )
+      end
+
+      sig { override.returns({ type: Symbol }) }
+      def to_hash
+      end
+    end
+  end
+end