openai 0.86.0 → 0.88.0

data/lib/openai/models/moderation.rb

@@ -28,16 +28,17 @@ module OpenAI
       required :flagged, OpenAI::Internal::Type::Boolean
 
       # @!method initialize(categories:, category_applied_input_types:, category_scores:, flagged:)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::Moderation} for more details.
+      #   @param categories [OpenAI::Models::Moderation::Categories]
+      #     A list of the categories, and whether they are flagged or not.
       #
-      #   @param categories [OpenAI::Models::Moderation::Categories] A list of the categories, and whether they are flagged or not.
+      #   @param category_applied_input_types [OpenAI::Models::Moderation::CategoryAppliedInputTypes]
+      #     A list of the categories along with the input type(s) that the score applies to.
       #
-      #   @param category_applied_input_types [OpenAI::Models::Moderation::CategoryAppliedInputTypes] A list of the categories along with the input type(s) that the score applies to.
+      #   @param category_scores [OpenAI::Models::Moderation::CategoryScores]
+      #     A list of the categories along with their scores as predicted by model.
       #
-      #   @param category_scores [OpenAI::Models::Moderation::CategoryScores] A list of the categories along with their scores as predicted by model.
-      #
-      #   @param flagged [Boolean] Whether any of the below categories are flagged.
+      #   @param flagged [Boolean]
+      #     Whether any of the below categories are flagged.
 
       # @see OpenAI::Models::Moderation#categories
       class Categories < OpenAI::Internal::Type::BaseModel
@@ -137,36 +138,63 @@ module OpenAI
         required :violence_graphic, OpenAI::Internal::Type::Boolean, api_name: :"violence/graphic"
 
         # @!method initialize(harassment:, harassment_threatening:, hate:, hate_threatening:, illicit:, illicit_violent:, self_harm:, self_harm_instructions:, self_harm_intent:, sexual:, sexual_minors:, violence:, violence_graphic:)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Moderation::Categories} for more details.
-        #
         #   A list of the categories, and whether they are flagged or not.
         #
-        #   @param harassment [Boolean] Content that expresses, incites, or promotes harassing language towards any targ
-        #
-        #   @param harassment_threatening [Boolean] Harassment content that also includes violence or serious harm towards any targe
-        #
-        #   @param hate [Boolean] Content that expresses, incites, or promotes hate based on race, gender, ethnici
-        #
-        #   @param hate_threatening [Boolean] Hateful content that also includes violence or serious harm towards the targeted
-        #
-        #   @param illicit [Boolean, nil] Content that includes instructions or advice that facilitate the planning or exe
-        #
-        #   @param illicit_violent [Boolean, nil] Content that includes instructions or advice that facilitate the planning or exe
-        #
-        #   @param self_harm [Boolean] Content that promotes, encourages, or depicts acts of self-harm, such as suicide
-        #
-        #   @param self_harm_instructions [Boolean] Content that encourages performing acts of self-harm, such as suicide, cutting,
-        #
-        #   @param self_harm_intent [Boolean] Content where the speaker expresses that they are engaging or intend to engage i
-        #
-        #   @param sexual [Boolean] Content meant to arouse sexual excitement, such as the description of sexual act
-        #
-        #   @param sexual_minors [Boolean] Sexual content that includes an individual who is under 18 years old.
-        #
-        #   @param violence [Boolean] Content that depicts death, violence, or physical injury.
-        #
-        #   @param violence_graphic [Boolean] Content that depicts death, violence, or physical injury in graphic detail.
+        #   @param harassment [Boolean]
+        #     Content that expresses, incites, or promotes harassing language towards any
+        #     target.
+        #
+        #   @param harassment_threatening [Boolean]
+        #     Harassment content that also includes violence or serious harm towards any
+        #     target.
+        #
+        #   @param hate [Boolean]
+        #     Content that expresses, incites, or promotes hate based on race, gender,
+        #     ethnicity, religion, nationality, sexual orientation, disability status, or
+        #     caste. Hateful content aimed at non-protected groups (e.g., chess players) is
+        #     harassment.
+        #
+        #   @param hate_threatening [Boolean]
+        #     Hateful content that also includes violence or serious harm towards the targeted
+        #     group based on race, gender, ethnicity, religion, nationality, sexual
+        #     orientation, disability status, or caste.
+        #
+        #   @param illicit [Boolean, nil]
+        #     Content that includes instructions or advice that facilitate the planning or
+        #     execution of wrongdoing, or that gives advice or instruction on how to commit
+        #     illicit acts. For example, "how to shoplift" would fit this category.
+        #
+        #   @param illicit_violent [Boolean, nil]
+        #     Content that includes instructions or advice that facilitate the planning or
+        #     execution of wrongdoing that also includes violence, or that gives advice or
+        #     instruction on the procurement of any weapon.
+        #
+        #   @param self_harm [Boolean]
+        #     Content that promotes, encourages, or depicts acts of self-harm, such as
+        #     suicide, cutting, and eating disorders.
+        #
+        #   @param self_harm_instructions [Boolean]
+        #     Content that encourages performing acts of self-harm, such as suicide, cutting,
+        #     and eating disorders, or that gives instructions or advice on how to commit such
+        #     acts.
+        #
+        #   @param self_harm_intent [Boolean]
+        #     Content where the speaker expresses that they are engaging or intend to engage
+        #     in acts of self-harm, such as suicide, cutting, and eating disorders.
+        #
+        #   @param sexual [Boolean]
+        #     Content meant to arouse sexual excitement, such as the description of sexual
+        #     activity, or that promotes sexual services (excluding sex education and
+        #     wellness).
+        #
+        #   @param sexual_minors [Boolean]
+        #     Sexual content that includes an individual who is under 18 years old.
+        #
+        #   @param violence [Boolean]
+        #     Content that depicts death, violence, or physical injury.
+        #
+        #   @param violence_graphic [Boolean]
+        #     Content that depicts death, violence, or physical injury in graphic detail.
       end
 
       # @see OpenAI::Models::Moderation#category_applied_input_types
@@ -315,32 +343,44 @@ module OpenAI
         # @!method initialize(harassment:, harassment_threatening:, hate:, hate_threatening:, illicit:, illicit_violent:, self_harm:, self_harm_instructions:, self_harm_intent:, sexual:, sexual_minors:, violence:, violence_graphic:)
         #   A list of the categories along with the input type(s) that the score applies to.
         #
-        #   @param harassment [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Harassment>] The applied input type(s) for the category 'harassment'.
+        #   @param harassment [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Harassment>]
+        #     The applied input type(s) for the category 'harassment'.
         #
-        #   @param harassment_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HarassmentThreatening>] The applied input type(s) for the category 'harassment/threatening'.
+        #   @param harassment_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HarassmentThreatening>]
+        #     The applied input type(s) for the category 'harassment/threatening'.
         #
-        #   @param hate [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Hate>] The applied input type(s) for the category 'hate'.
+        #   @param hate [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Hate>]
+        #     The applied input type(s) for the category 'hate'.
         #
-        #   @param hate_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HateThreatening>] The applied input type(s) for the category 'hate/threatening'.
+        #   @param hate_threatening [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::HateThreatening>]
+        #     The applied input type(s) for the category 'hate/threatening'.
         #
-        #   @param illicit [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Illicit>] The applied input type(s) for the category 'illicit'.
+        #   @param illicit [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Illicit>]
+        #     The applied input type(s) for the category 'illicit'.
         #
-        #   @param illicit_violent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::IllicitViolent>] The applied input type(s) for the category 'illicit/violent'.
+        #   @param illicit_violent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::IllicitViolent>]
+        #     The applied input type(s) for the category 'illicit/violent'.
         #
-        #   @param self_harm [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarm>] The applied input type(s) for the category 'self-harm'.
+        #   @param self_harm [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarm>]
+        #     The applied input type(s) for the category 'self-harm'.
         #
-        #   @param self_harm_instructions [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmInstruction>] The applied input type(s) for the category 'self-harm/instructions'.
+        #   @param self_harm_instructions [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmInstruction>]
+        #     The applied input type(s) for the category 'self-harm/instructions'.
         #
-        #   @param self_harm_intent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmIntent>] The applied input type(s) for the category 'self-harm/intent'.
+        #   @param self_harm_intent [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SelfHarmIntent>]
+        #     The applied input type(s) for the category 'self-harm/intent'.
         #
-        #   @param sexual [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Sexual>] The applied input type(s) for the category 'sexual'.
+        #   @param sexual [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Sexual>]
+        #     The applied input type(s) for the category 'sexual'.
         #
-        #   @param sexual_minors [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SexualMinor>] The applied input type(s) for the category 'sexual/minors'.
+        #   @param sexual_minors [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::SexualMinor>]
+        #     The applied input type(s) for the category 'sexual/minors'.
         #
-        #   @param violence [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Violence>] The applied input type(s) for the category 'violence'.
+        #   @param violence [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::Violence>]
+        #     The applied input type(s) for the category 'violence'.
         #
-        #   @param violence_graphic [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::ViolenceGraphic>] The applied input type(s) for the category 'violence/graphic'.
-
+        #   @param violence_graphic [Array<Symbol, OpenAI::Models::Moderation::CategoryAppliedInputTypes::ViolenceGraphic>]
+        #     The applied input type(s) for the category 'violence/graphic'.
         module Harassment
           extend OpenAI::Internal::Type::Enum
 
@@ -548,31 +588,44 @@ module OpenAI
         # @!method initialize(harassment:, harassment_threatening:, hate:, hate_threatening:, illicit:, illicit_violent:, self_harm:, self_harm_instructions:, self_harm_intent:, sexual:, sexual_minors:, violence:, violence_graphic:)
         #   A list of the categories along with their scores as predicted by model.
         #
-        #   @param harassment [Float] The score for the category 'harassment'.
+        #   @param harassment [Float]
+        #     The score for the category 'harassment'.
         #
-        #   @param harassment_threatening [Float] The score for the category 'harassment/threatening'.
+        #   @param harassment_threatening [Float]
+        #     The score for the category 'harassment/threatening'.
         #
-        #   @param hate [Float] The score for the category 'hate'.
+        #   @param hate [Float]
+        #     The score for the category 'hate'.
         #
-        #   @param hate_threatening [Float] The score for the category 'hate/threatening'.
+        #   @param hate_threatening [Float]
+        #     The score for the category 'hate/threatening'.
         #
-        #   @param illicit [Float] The score for the category 'illicit'.
+        #   @param illicit [Float]
+        #     The score for the category 'illicit'.
         #
-        #   @param illicit_violent [Float] The score for the category 'illicit/violent'.
+        #   @param illicit_violent [Float]
+        #     The score for the category 'illicit/violent'.
         #
-        #   @param self_harm [Float] The score for the category 'self-harm'.
+        #   @param self_harm [Float]
+        #     The score for the category 'self-harm'.
         #
-        #   @param self_harm_instructions [Float] The score for the category 'self-harm/instructions'.
+        #   @param self_harm_instructions [Float]
+        #     The score for the category 'self-harm/instructions'.
         #
-        #   @param self_harm_intent [Float] The score for the category 'self-harm/intent'.
+        #   @param self_harm_intent [Float]
+        #     The score for the category 'self-harm/intent'.
         #
-        #   @param sexual [Float] The score for the category 'sexual'.
+        #   @param sexual [Float]
+        #     The score for the category 'sexual'.
         #
-        #   @param sexual_minors [Float] The score for the category 'sexual/minors'.
+        #   @param sexual_minors [Float]
+        #     The score for the category 'sexual/minors'.
         #
-        #   @param violence [Float] The score for the category 'violence'.
+        #   @param violence [Float]
+        #     The score for the category 'violence'.
         #
-        #   @param violence_graphic [Float] The score for the category 'violence/graphic'.
+        #   @param violence_graphic [Float]
+        #     The score for the category 'violence/graphic'.
       end
     end
   end

data/lib/openai/models/moderation_create_params.rb

@@ -16,20 +16,23 @@ module OpenAI
 
       # @!attribute model
       #   The content moderation model you would like to use. Learn more in
-      #   [the moderation guide](https://platform.openai.com/docs/guides/moderation), and
-      #   learn about available models
-      #   [here](https://platform.openai.com/docs/models#moderation).
+      #   [the moderation guide](https://developers.openai.com/api/docs/guides/moderation),
+      #   and learn about available models
+      #   [here](https://developers.openai.com/api/docs/guides/moderation).
       #
       #   @return [String, Symbol, OpenAI::Models::ModerationModel, nil]
       optional :model, union: -> { OpenAI::ModerationCreateParams::Model }
 
       # @!method initialize(input:, model: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::ModerationCreateParams} for more details.
+      #   @param input [String, Array<String>, Array<OpenAI::Models::ModerationImageURLInput, OpenAI::Models::ModerationTextInput>]
+      #     Input (or inputs) to classify. Can be a single string, an array of strings, or
+      #     an array of multi-modal input objects similar to other models.
       #
-      #   @param input [String, Array<String>, Array<OpenAI::Models::ModerationImageURLInput, OpenAI::Models::ModerationTextInput>] Input (or inputs) to classify. Can be a single string, an array of strings, or
-      #
-      #   @param model [String, Symbol, OpenAI::Models::ModerationModel] The content moderation model you would like to use. Learn more in
+      #   @param model [String, Symbol, OpenAI::Models::ModerationModel]
+      #     The content moderation model you would like to use. Learn more in
+      #     [the moderation guide](https://developers.openai.com/api/docs/guides/moderation),
+      #     and learn about available models
+      #     [here](https://developers.openai.com/api/docs/guides/moderation).
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -60,17 +63,17 @@ module OpenAI
       end
 
       # The content moderation model you would like to use. Learn more in
-      # [the moderation guide](https://platform.openai.com/docs/guides/moderation), and
-      # learn about available models
-      # [here](https://platform.openai.com/docs/models#moderation).
+      # [the moderation guide](https://developers.openai.com/api/docs/guides/moderation),
+      # and learn about available models
+      # [here](https://developers.openai.com/api/docs/guides/moderation).
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
         # The content moderation model you would like to use. Learn more in
-        # [the moderation guide](https://platform.openai.com/docs/guides/moderation), and learn about
-        # available models [here](https://platform.openai.com/docs/models#moderation).
+        # [the moderation guide](https://developers.openai.com/api/docs/guides/moderation), and learn about
+        # available models [here](https://developers.openai.com/api/docs/guides/moderation).
         variant enum: -> { OpenAI::ModerationModel }
 
         # @!method self.variants

data/lib/openai/models/moderation_create_response.rb

@@ -25,11 +25,14 @@ module OpenAI
       # @!method initialize(id:, model:, results:)
       #   Represents if a given text input is potentially harmful.
       #
-      #   @param id [String] The unique identifier for the moderation request.
+      #   @param id [String]
+      #     The unique identifier for the moderation request.
       #
-      #   @param model [String] The model used to generate the moderation results.
+      #   @param model [String]
+      #     The model used to generate the moderation results.
       #
-      #   @param results [Array<OpenAI::Models::Moderation>] A list of moderation objects.
+      #   @param results [Array<OpenAI::Models::Moderation>]
+      #     A list of moderation objects.
     end
   end
 end

data/lib/openai/models/moderation_image_url_input.rb

@@ -18,9 +18,11 @@ module OpenAI
       # @!method initialize(image_url:, type: :image_url)
       #   An object describing an image to classify.
       #
-      #   @param image_url [OpenAI::Models::ModerationImageURLInput::ImageURL] Contains either an image URL or a data URL for a base64 encoded image.
+      #   @param image_url [OpenAI::Models::ModerationImageURLInput::ImageURL]
+      #     Contains either an image URL or a data URL for a base64 encoded image.
       #
-      #   @param type [Symbol, :image_url] Always `image_url`.
+      #   @param type [Symbol, :image_url]
+      #     Always `image_url`.
 
       # @see OpenAI::Models::ModerationImageURLInput#image_url
       class ImageURL < OpenAI::Internal::Type::BaseModel
@@ -33,7 +35,8 @@ module OpenAI
         # @!method initialize(url:)
         #   Contains either an image URL or a data URL for a base64 encoded image.
         #
-        #   @param url [String] Either a URL of the image or the base64 encoded image data.
+        #   @param url [String]
+        #     Either a URL of the image or the base64 encoded image data.
       end
     end
   end

data/lib/openai/models/moderation_text_input.rb

@@ -18,9 +18,11 @@ module OpenAI
       # @!method initialize(text:, type: :text)
       #   An object describing text to classify.
       #
-      #   @param text [String] A string of text to classify.
+      #   @param text [String]
+      #     A string of text to classify.
       #
-      #   @param type [Symbol, :text] Always `text`.
+      #   @param type [Symbol, :text]
+      #     Always `text`.
     end
   end
 end

data/lib/openai/models/other_file_chunking_strategy_object.rb

@@ -14,7 +14,8 @@ module OpenAI
       #   because the file was indexed before the `chunking_strategy` concept was
       #   introduced in the API.
       #
-      #   @param type [Symbol, :other] Always `other`.
+      #   @param type [Symbol, :other]
+      #     Always `other`.
     end
   end
 end

data/lib/openai/models/realtime/audio_transcription.rb

@@ -48,7 +48,7 @@ module OpenAI
         # @!attribute prompt
         #   An optional text to guide the model's style or continue a previous audio
         #   segment. For `whisper-1`, the
-        #   [prompt is a list of keywords](https://platform.openai.com/docs/guides/speech-to-text#prompting).
+        #   [prompt is a list of keywords](https://developers.openai.com/api/docs/guides/speech-to-text#prompting).
         #   For `gpt-4o-transcribe` models (excluding `gpt-4o-transcribe-diarize`), the
         #   prompt is a free text string, for example "expect words related to technology".
         #   Prompt is not supported with `gpt-realtime-whisper` in GA Realtime sessions.
@@ -57,20 +57,39 @@ module OpenAI
         optional :prompt, String
 
         # @!method initialize(delay: nil, keywords: nil, language: nil, languages: nil, model: nil, prompt: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::AudioTranscription} for more details.
+        #   @param delay [Symbol, OpenAI::Models::Realtime::AudioTranscription::Delay]
+        #     Controls how long the model waits before emitting transcription text. Higher
+        #     values can improve transcription accuracy at the cost of latency. Only supported
+        #     with `gpt-realtime-whisper` in GA Realtime sessions.
         #
-        #   @param delay [Symbol, OpenAI::Models::Realtime::AudioTranscription::Delay] Controls how long the model waits before emitting transcription text.
+        #   @param keywords [Array<String>]
+        #     Words or phrases to guide transcription of the input audio. Supported by
+        #     `gpt-transcribe` and `gpt-live-transcribe`.
         #
-        #   @param keywords [Array<String>] Words or phrases to guide transcription of the input audio. Supported by `gpt-tr
+        #   @param language [String]
+        #     The language of the input audio. Supplying the input language in
+        #     [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
+        #     format will improve accuracy and latency.
         #
-        #   @param language [String] The language of the input audio. Supplying the input language in
+        #   @param languages [Array<String>]
+        #     Possible languages of the input audio, in
+        #     [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+        #     Supported by `gpt-transcribe` and `gpt-live-transcribe`.
         #
-        #   @param languages [Array<String>] Possible languages of the input audio, in [ISO-639-1](https://en.wikipedia.org/w
+        #   @param model [String, Symbol, OpenAI::Models::Realtime::AudioTranscription::Model]
+        #     The model to use for transcription. Current options are `whisper-1`,
+        #     `gpt-transcribe`, `gpt-live-transcribe`, `gpt-4o-mini-transcribe`,
+        #     `gpt-4o-mini-transcribe-2025-12-15`, `gpt-4o-transcribe`,
+        #     `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`. Use
+        #     `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         #
-        #   @param model [String, Symbol, OpenAI::Models::Realtime::AudioTranscription::Model] The model to use for transcription. Current options are `whisper-1`, `gpt-transc
-        #
-        #   @param prompt [String] An optional text to guide the model's style or continue a previous audio
+        #   @param prompt [String]
+        #     An optional text to guide the model's style or continue a previous audio
+        #     segment. For `whisper-1`, the
+        #     [prompt is a list of keywords](https://developers.openai.com/api/docs/guides/speech-to-text#prompting).
+        #     For `gpt-4o-transcribe` models (excluding `gpt-4o-transcribe-diarize`), the
+        #     prompt is a free text string, for example "expect words related to technology".
+        #     Prompt is not supported with `gpt-realtime-whisper` in GA Realtime sessions.
 
         # Controls how long the model waits before emitting transcription text. Higher
         # values can improve transcription accuracy at the cost of latency. Only supported

data/lib/openai/models/realtime/call_accept_params.rb

@@ -14,38 +14,93 @@ module OpenAI
         required :call_id, String
 
         # @!method initialize(call_id:, audio: nil, include: nil, instructions: nil, max_output_tokens: nil, model: nil, output_modalities: nil, parallel_tool_calls: nil, prompt: nil, reasoning: nil, tool_choice: nil, tools: nil, tracing: nil, truncation: nil, type: :realtime, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::CallAcceptParams} for more details.
-        #
         #   @param call_id [String]
         #
-        #   @param audio [OpenAI::Models::Realtime::RealtimeAudioConfig] Configuration for input and output audio.
-        #
-        #   @param include [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Include>] Additional fields to include in server outputs.
-        #
-        #   @param instructions [String] The default system instructions (i.e. system message) prepended to model calls.
-        #
-        #   @param max_output_tokens [Integer, Symbol, :inf] Maximum number of output tokens for a single assistant response,
-        #
-        #   @param model [String, Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model] The Realtime model used for this session.
-        #
-        #   @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::OutputModality>] The set of modalities the model can respond with. It defaults to `["audio"]`, in
-        #
-        #   @param parallel_tool_calls [Boolean] Whether the model may call multiple tools in parallel. Only supported by
-        #
-        #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
-        #
-        #   @param reasoning [OpenAI::Models::Realtime::RealtimeReasoning] Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
-        #
-        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp] How the model chooses tools. Provide one of the string modes or force a specific
-        #
-        #   @param tools [Array<OpenAI::Models::Realtime::RealtimeFunctionTool, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp>] Tools available to the model.
-        #
-        #   @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil] Realtime API can write session traces to the [Traces Dashboard](https://platform
-        #
-        #   @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] When the number of tokens in a conversation exceeds the model's input token limi
-        #
-        #   @param type [Symbol, :realtime] The type of session to create. Always `realtime` for the Realtime API.
+        #   @param audio [OpenAI::Models::Realtime::RealtimeAudioConfig]
+        #     Configuration for input and output audio.
+        #
+        #   @param include [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Include>]
+        #     Additional fields to include in server outputs.
+        #
+        #     `item.input_audio_transcription.logprobs`: Include logprobs for input audio
+        #     transcription.
+        #
+        #   @param instructions [String]
+        #     The default system instructions (i.e. system message) prepended to model calls.
+        #     This field allows the client to guide the model on desired responses. The model
+        #     can be instructed on response content and format, (e.g. "be extremely succinct",
+        #     "act friendly", "here are examples of good responses") and on audio behavior
+        #     (e.g. "talk quickly", "inject emotion into your voice", "laugh frequently"). The
+        #     instructions are not guaranteed to be followed by the model, but they provide
+        #     guidance to the model on the desired behavior.
+        #
+        #     Note that the server sets default instructions which will be used if this field
+        #     is not set and are visible in the `session.created` event at the start of the
+        #     session.
+        #
+        #   @param max_output_tokens [Integer, Symbol, :inf]
+        #     Maximum number of output tokens for a single assistant response, inclusive of
+        #     tool calls. Provide an integer between 1 and 4096 to limit output tokens, or
+        #     `inf` for the maximum available tokens for a given model. Defaults to `inf`.
+        #
+        #   @param model [String, Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model]
+        #     The Realtime model used for this session.
+        #
+        #   @param output_modalities [Array<Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateRequest::OutputModality>]
+        #     The set of modalities the model can respond with. It defaults to `["audio"]`,
+        #     indicating that the model will respond with audio plus a transcript. `["text"]`
+        #     can be used to make the model respond with text only. It is not possible to
+        #     request both `text` and `audio` at the same time.
+        #
+        #   @param parallel_tool_calls [Boolean]
+        #     Whether the model may call multiple tools in parallel. Only supported by
+        #     reasoning Realtime models such as `gpt-realtime-2`.
+        #
+        #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil]
+        #     Reference to a prompt template and its variables.
+        #     [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
+        #
+        #   @param reasoning [OpenAI::Models::Realtime::RealtimeReasoning]
+        #     Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
+        #
+        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp]
+        #     How the model chooses tools. Provide one of the string modes or force a specific
+        #     function/MCP tool.
+        #
+        #   @param tools [Array<OpenAI::Models::Realtime::RealtimeFunctionTool, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp>]
+        #     Tools available to the model.
+        #
+        #   @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil]
+        #     Realtime API can write session traces to the
+        #     [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.
+        #
+        #   @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio]
+        #     When the number of tokens in a conversation exceeds the model's input token
+        #     limit, the conversation be truncated, meaning messages (starting from the
+        #     oldest) will not be included in the model's context. A 32k context model with
+        #     4,096 max output tokens can only include 28,224 tokens in the context before
+        #     truncation occurs.
+        #
+        #     Clients can configure truncation behavior to truncate with a lower max token
+        #     limit, which is an effective way to control token usage and cost.
+        #
+        #     Truncation will reduce the number of cached tokens on the next turn (busting the
+        #     cache), since messages are dropped from the beginning of the context. However,
+        #     clients can also configure truncation to retain messages up to a fraction of the
+        #     maximum context size, which will reduce the need for future truncations and thus
+        #     improve the cache rate.
+        #
+        #     Truncation can be disabled entirely, which means the server will never truncate
+        #     but would instead return an error if the conversation exceeds the model's input
+        #     token limit.
+        #
+        #   @param type [Symbol, :realtime]
+        #     The type of session to create. Always `realtime` for the Realtime API.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/realtime/call_create_params.rb

@@ -21,9 +21,11 @@ module OpenAI
         optional :session, -> { OpenAI::Realtime::RealtimeSessionCreateRequest }
 
         # @!method initialize(sdp:, session: nil, request_options: {})
-        #   @param sdp [String] WebRTC Session Description Protocol (SDP) offer generated by the caller.
+        #   @param sdp [String]
+        #     WebRTC Session Description Protocol (SDP) offer generated by the caller.
         #
-        #   @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest] Realtime session object configuration.
+        #   @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest]
+        #     Realtime session object configuration.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/realtime/call_refer_params.rb

@@ -21,12 +21,11 @@ module OpenAI
         required :target_uri, String
 
         # @!method initialize(call_id:, target_uri:, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::CallReferParams} for more details.
-        #
         #   @param call_id [String]
         #
-        #   @param target_uri [String] URI that should appear in the SIP Refer-To header. Supports values like
+        #   @param target_uri [String]
+        #     URI that should appear in the SIP Refer-To header. Supports values like
+        #     `tel:+14155550123` or `sip:agent@example.com`.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/realtime/call_reject_params.rb

@@ -21,12 +21,11 @@ module OpenAI
         optional :status_code, Integer
 
         # @!method initialize(call_id:, status_code: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Realtime::CallRejectParams} for more details.
-        #
         #   @param call_id [String]
         #
-        #   @param status_code [Integer] SIP response code to send back to the caller. Defaults to `603` (Decline)
+        #   @param status_code [Integer]
+        #     SIP response code to send back to the caller. Defaults to `603` (Decline) when
+        #     omitted.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end