openai 0.87.0 → 0.89.0

data/lib/openai/models/admin/organization/users/role_list_response.rb

@@ -95,30 +95,41 @@ module OpenAI
             #   Detailed information about a role assignment entry returned when listing
             #   assignments.
             #
-            #   @param id [String] Identifier for the role.
+            #   @param id [String]
+            #     Identifier for the role.
             #
-            #   @param assignment_sources [Array<OpenAI::Models::Admin::Organization::Users::RoleListResponse::AssignmentSource>, nil] Principals from which the role assignment is inherited, when available.
+            #   @param assignment_sources [Array<OpenAI::Models::Admin::Organization::Users::RoleListResponse::AssignmentSource>, nil]
+            #     Principals from which the role assignment is inherited, when available.
             #
-            #   @param created_at [Integer, nil] When the role was created.
+            #   @param created_at [Integer, nil]
+            #     When the role was created.
             #
-            #   @param created_by [String, nil] Identifier of the actor who created the role.
+            #   @param created_by [String, nil]
+            #     Identifier of the actor who created the role.
             #
-            #   @param created_by_user_obj [Hash{Symbol=>Object}, nil] User details for the actor that created the role, when available.
+            #   @param created_by_user_obj [Hash{Symbol=>Object}, nil]
+            #     User details for the actor that created the role, when available.
             #
-            #   @param description [String, nil] Description of the role.
+            #   @param description [String, nil]
+            #     Description of the role.
             #
-            #   @param metadata [Hash{Symbol=>Object}, nil] Arbitrary metadata stored on the role.
+            #   @param metadata [Hash{Symbol=>Object}, nil]
+            #     Arbitrary metadata stored on the role.
             #
-            #   @param name [String] Name of the role.
+            #   @param name [String]
+            #     Name of the role.
             #
-            #   @param permissions [Array<String>] Permissions associated with the role.
+            #   @param permissions [Array<String>]
+            #     Permissions associated with the role.
             #
-            #   @param predefined_role [Boolean] Whether the role is predefined by OpenAI.
+            #   @param predefined_role [Boolean]
+            #     Whether the role is predefined by OpenAI.
             #
-            #   @param resource_type [String] Resource type the role applies to.
+            #   @param resource_type [String]
+            #     Resource type the role applies to.
             #
-            #   @param updated_at [Integer, nil] When the role was last updated.
-
+            #   @param updated_at [Integer, nil]
+            #     When the role was last updated.
             class AssignmentSource < OpenAI::Internal::Type::BaseModel
               # @!attribute principal_id
               #

data/lib/openai/models/admin/organization/users/role_retrieve_response.rb

@@ -95,30 +95,41 @@ module OpenAI
             #   Detailed information about a role assignment entry returned when listing
             #   assignments.
             #
-            #   @param id [String] Identifier for the role.
+            #   @param id [String]
+            #     Identifier for the role.
             #
-            #   @param assignment_sources [Array<OpenAI::Models::Admin::Organization::Users::RoleRetrieveResponse::AssignmentSource>, nil] Principals from which the role assignment is inherited, when available.
+            #   @param assignment_sources [Array<OpenAI::Models::Admin::Organization::Users::RoleRetrieveResponse::AssignmentSource>, nil]
+            #     Principals from which the role assignment is inherited, when available.
             #
-            #   @param created_at [Integer, nil] When the role was created.
+            #   @param created_at [Integer, nil]
+            #     When the role was created.
             #
-            #   @param created_by [String, nil] Identifier of the actor who created the role.
+            #   @param created_by [String, nil]
+            #     Identifier of the actor who created the role.
             #
-            #   @param created_by_user_obj [Hash{Symbol=>Object}, nil] User details for the actor that created the role, when available.
+            #   @param created_by_user_obj [Hash{Symbol=>Object}, nil]
+            #     User details for the actor that created the role, when available.
             #
-            #   @param description [String, nil] Description of the role.
+            #   @param description [String, nil]
+            #     Description of the role.
             #
-            #   @param metadata [Hash{Symbol=>Object}, nil] Arbitrary metadata stored on the role.
+            #   @param metadata [Hash{Symbol=>Object}, nil]
+            #     Arbitrary metadata stored on the role.
             #
-            #   @param name [String] Name of the role.
+            #   @param name [String]
+            #     Name of the role.
             #
-            #   @param permissions [Array<String>] Permissions associated with the role.
+            #   @param permissions [Array<String>]
+            #     Permissions associated with the role.
             #
-            #   @param predefined_role [Boolean] Whether the role is predefined by OpenAI.
+            #   @param predefined_role [Boolean]
+            #     Whether the role is predefined by OpenAI.
             #
-            #   @param resource_type [String] Resource type the role applies to.
+            #   @param resource_type [String]
+            #     Resource type the role applies to.
             #
-            #   @param updated_at [Integer, nil] When the role was last updated.
-
+            #   @param updated_at [Integer, nil]
+            #     When the role was last updated.
             class AssignmentSource < OpenAI::Internal::Type::BaseModel
               # @!attribute principal_id
               #

data/lib/openai/models/audio/speech_create_params.rb

@@ -15,7 +15,8 @@ module OpenAI
         required :input, String
 
         # @!attribute model
-        #   One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+        #   One of the available
+        #   [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
         #   `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         #
         #   @return [String, Symbol, OpenAI::Models::Audio::SpeechModel]
@@ -27,7 +28,7 @@ module OpenAI
         #   `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
         #   object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #   voices are available in the
-        #   [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+        #   [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
         #
         #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice]
         required :voice, union: -> { OpenAI::Audio::SpeechCreateParams::Voice }
@@ -61,33 +62,49 @@ module OpenAI
         optional :stream_format, enum: -> { OpenAI::Audio::SpeechCreateParams::StreamFormat }
 
         # @!method initialize(input:, model:, voice:, instructions: nil, response_format: nil, speed: nil, stream_format: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Audio::SpeechCreateParams} for more details.
+        #   @param input [String]
+        #     The text to generate audio for. The maximum length is 4096 characters.
         #
-        #   @param input [String] The text to generate audio for. The maximum length is 4096 characters.
+        #   @param model [String, Symbol, OpenAI::Models::Audio::SpeechModel]
+        #     One of the available
+        #     [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
+        #     `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         #
-        #   @param model [String, Symbol, OpenAI::Models::Audio::SpeechModel] One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+        #   @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice]
+        #     The voice to use when generating the audio. Supported built-in voices are
+        #     `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+        #     `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
+        #     object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
+        #     voices are available in the
+        #     [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
         #
-        #   @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice] The voice to use when generating the audio. Supported built-in voices are `alloy
+        #   @param instructions [String]
+        #     Control the voice of your generated audio with additional instructions. Does not
+        #     work with `tts-1` or `tts-1-hd`.
         #
-        #   @param instructions [String] Control the voice of your generated audio with additional instructions. Does not
+        #   @param response_format [Symbol, OpenAI::Models::Audio::SpeechCreateParams::ResponseFormat]
+        #     The format to audio in. Supported formats are `mp3`, `opus`, `aac`, `flac`,
+        #     `wav`, and `pcm`.
         #
-        #   @param response_format [Symbol, OpenAI::Models::Audio::SpeechCreateParams::ResponseFormat] The format to audio in. Supported formats are `mp3`, `opus`, `aac`, `flac`, `wav
+        #   @param speed [Float]
+        #     The speed of the generated audio. Select a value from `0.25` to `4.0`. `1.0` is
+        #     the default.
         #
-        #   @param speed [Float] The speed of the generated audio. Select a value from `0.25` to `4.0`. `1.0` is
-        #
-        #   @param stream_format [Symbol, OpenAI::Models::Audio::SpeechCreateParams::StreamFormat] The format to stream the audio in. Supported formats are `sse` and `audio`. `sse
+        #   @param stream_format [Symbol, OpenAI::Models::Audio::SpeechCreateParams::StreamFormat]
+        #     The format to stream the audio in. Supported formats are `sse` and `audio`.
+        #     `sse` is not supported for `tts-1` or `tts-1-hd`.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-        # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
+        # One of the available
+        # [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech):
         # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         module Model
           extend OpenAI::Internal::Type::Union
 
           variant String
 
-          # One of the available [TTS models](https://platform.openai.com/docs/models#tts): `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
+          # One of the available [TTS models](https://developers.openai.com/api/docs/guides/text-to-speech): `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
           variant enum: -> { OpenAI::Audio::SpeechModel }
 
           # @!method self.variants
@@ -99,7 +116,7 @@ module OpenAI
         # `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
         # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         # voices are available in the
-        # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
+        # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
         module Voice
           extend OpenAI::Internal::Type::Union
 
@@ -138,7 +155,8 @@ module OpenAI
             # @!method initialize(id:)
             #   Custom voice reference.
             #
-            #   @param id [String] The custom voice ID, e.g. `voice_1234`.
+            #   @param id [String]
+            #     The custom voice ID, e.g. `voice_1234`.
           end
 
           # @!method self.variants

data/lib/openai/models/audio/transcription.rb

@@ -32,20 +32,23 @@ module OpenAI
         optional :usage, union: -> { OpenAI::Audio::Transcription::Usage }
 
         # @!method initialize(text:, languages: nil, logprobs: nil, usage: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Audio::Transcription} for more details.
-        #
         #   Represents a transcription response returned by model, based on the provided
         #   input.
         #
-        #   @param text [String] The transcribed text.
+        #   @param text [String]
+        #     The transcribed text.
         #
-        #   @param languages [Array<OpenAI::Models::Audio::TranscriptionLanguage>] The languages detected in the audio. Returned by `gpt-transcribe`. An empty arra
+        #   @param languages [Array<OpenAI::Models::Audio::TranscriptionLanguage>]
+        #     The languages detected in the audio. Returned by `gpt-transcribe`. An empty
+        #     array indicates that no language could be reliably detected.
         #
-        #   @param logprobs [Array<OpenAI::Models::Audio::Transcription::Logprob>] The log probabilities of the tokens in the transcription. Only returned with the
+        #   @param logprobs [Array<OpenAI::Models::Audio::Transcription::Logprob>]
+        #     The log probabilities of the tokens in the transcription. Only returned with the
+        #     models `gpt-4o-transcribe` and `gpt-4o-mini-transcribe` if `logprobs` is added
+        #     to the `include` array.
         #
-        #   @param usage [OpenAI::Models::Audio::Transcription::Usage::Tokens, OpenAI::Models::Audio::Transcription::Usage::Duration] Token usage statistics for the request.
-
+        #   @param usage [OpenAI::Models::Audio::Transcription::Usage::Tokens, OpenAI::Models::Audio::Transcription::Usage::Duration]
+        #     Token usage statistics for the request.
         class Logprob < OpenAI::Internal::Type::BaseModel
           # @!attribute token
           #   The token in the transcription.
@@ -66,11 +69,14 @@ module OpenAI
           optional :logprob, Float
 
           # @!method initialize(token: nil, bytes: nil, logprob: nil)
-          #   @param token [String] The token in the transcription.
+          #   @param token [String]
+          #     The token in the transcription.
           #
-          #   @param bytes [Array<Float>] The bytes of the token.
+          #   @param bytes [Array<Float>]
+          #     The bytes of the token.
           #
-          #   @param logprob [Float] The log probability of the token.
+          #   @param logprob [Float]
+          #     The log probability of the token.
         end
 
         # Token usage statistics for the request.
@@ -121,15 +127,20 @@ module OpenAI
             # @!method initialize(input_tokens:, output_tokens:, total_tokens:, input_token_details: nil, type: :tokens)
             #   Usage statistics for models billed by token usage.
             #
-            #   @param input_tokens [Integer] Number of input tokens billed for this request.
+            #   @param input_tokens [Integer]
+            #     Number of input tokens billed for this request.
             #
-            #   @param output_tokens [Integer] Number of output tokens generated.
+            #   @param output_tokens [Integer]
+            #     Number of output tokens generated.
             #
-            #   @param total_tokens [Integer] Total number of tokens used (input + output).
+            #   @param total_tokens [Integer]
+            #     Total number of tokens used (input + output).
             #
-            #   @param input_token_details [OpenAI::Models::Audio::Transcription::Usage::Tokens::InputTokenDetails] Details about the input tokens billed for this request.
+            #   @param input_token_details [OpenAI::Models::Audio::Transcription::Usage::Tokens::InputTokenDetails]
+            #     Details about the input tokens billed for this request.
             #
-            #   @param type [Symbol, :tokens] The type of the usage object. Always `tokens` for this variant.
+            #   @param type [Symbol, :tokens]
+            #     The type of the usage object. Always `tokens` for this variant.
 
             # @see OpenAI::Models::Audio::Transcription::Usage::Tokens#input_token_details
             class InputTokenDetails < OpenAI::Internal::Type::BaseModel
@@ -148,9 +159,11 @@ module OpenAI
               # @!method initialize(audio_tokens: nil, text_tokens: nil)
               #   Details about the input tokens billed for this request.
               #
-              #   @param audio_tokens [Integer] Number of audio tokens billed for this request.
+              #   @param audio_tokens [Integer]
+              #     Number of audio tokens billed for this request.
               #
-              #   @param text_tokens [Integer] Number of text tokens billed for this request.
+              #   @param text_tokens [Integer]
+              #     Number of text tokens billed for this request.
             end
           end
 
@@ -170,9 +183,11 @@ module OpenAI
             # @!method initialize(seconds:, type: :duration)
             #   Usage statistics for models billed by audio input duration.
             #
-            #   @param seconds [Float] Duration of the input audio in seconds.
+            #   @param seconds [Float]
+            #     Duration of the input audio in seconds.
             #
-            #   @param type [Symbol, :duration] The type of the usage object. Always `duration` for this variant.
+            #   @param type [Symbol, :duration]
+            #     The type of the usage object. Always `duration` for this variant.
           end
 
           # @!method self.variants

data/lib/openai/models/audio/transcription_create_params.rb

@@ -102,7 +102,7 @@ module OpenAI
         # @!attribute prompt
         #   An optional text to guide the model's style or continue a previous audio
         #   segment. The
-        #   [prompt](https://platform.openai.com/docs/guides/speech-to-text#prompting)
+        #   [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting)
         #   should match the audio language. This field is not supported when using
         #   `gpt-4o-transcribe-diarize`.
         #
@@ -144,34 +144,92 @@ module OpenAI
         )
 
         # @!method initialize(file:, model:, chunking_strategy: nil, include: nil, keywords: nil, known_speaker_names: nil, known_speaker_references: nil, language: nil, languages: nil, prompt: nil, response_format: nil, temperature: nil, timestamp_granularities: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Audio::TranscriptionCreateParams} for more details.
+        #   @param file [Pathname, StringIO, IO, String, OpenAI::FilePart]
+        #     The audio file object (not file name) to transcribe, in one of these formats:
+        #     flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. The request must include
+        #     enough format metadata for the file to be identified. We recommend an
+        #     extension-bearing filename and an appropriate content type.
         #
-        #   @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The audio file object (not file name) to transcribe, in one of these formats: fl
+        #     `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+        #     metadata. Use `OpenAI::FilePart` when you need to override the filename or
+        #     content type.
         #
-        #   @param model [String, Symbol, OpenAI::Models::AudioModel] ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`, `
+        #   @param model [String, Symbol, OpenAI::Models::AudioModel]
+        #     ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
+        #     `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
+        #     (which is powered by our open source Whisper V2 model), and
+        #     `gpt-4o-transcribe-diarize`.
         #
-        #   @param chunking_strategy [Symbol, :auto, OpenAI::Models::Audio::TranscriptionCreateParams::ChunkingStrategy::VadConfig, nil] Controls how the audio is cut into chunks. When set to `"auto"`, the server firs
+        #   @param chunking_strategy [Symbol, :auto, OpenAI::Models::Audio::TranscriptionCreateParams::ChunkingStrategy::VadConfig, nil]
+        #     Controls how the audio is cut into chunks. When set to `"auto"`, the server
+        #     first normalizes loudness and then uses voice activity detection (VAD) to choose
+        #     boundaries. `server_vad` object can be provided to tweak VAD detection
+        #     parameters manually. If unset, the audio is transcribed as a single block.
+        #     Required when using `gpt-4o-transcribe-diarize` for inputs longer than 30
+        #     seconds.
         #
-        #   @param include [Array<Symbol, OpenAI::Models::Audio::TranscriptionInclude>] Additional information to include in the transcription response.
+        #   @param include [Array<Symbol, OpenAI::Models::Audio::TranscriptionInclude>]
+        #     Additional information to include in the transcription response. `logprobs` will
+        #     return the log probabilities of the tokens in the response to understand the
+        #     model's confidence in the transcription. `logprobs` only works with
+        #     response_format set to `json` and only with the models `gpt-4o-transcribe`,
+        #     `gpt-4o-mini-transcribe`, and `gpt-4o-mini-transcribe-2025-12-15`. This field is
+        #     not supported when using `gpt-4o-transcribe-diarize`.
         #
-        #   @param keywords [Array<String>] Words or phrases to guide transcription of the input audio. Supported by `gpt-tr
+        #   @param keywords [Array<String>]
+        #     Words or phrases to guide transcription of the input audio. Supported by
+        #     `gpt-transcribe`.
         #
-        #   @param known_speaker_names [Array<String>] Optional list of speaker names that correspond to the audio samples provided in
+        #   @param known_speaker_names [Array<String>]
+        #     Optional list of speaker names that correspond to the audio samples provided in
+        #     `known_speaker_references[]`. Each entry should be a short identifier (for
+        #     example `customer` or `agent`). Up to 4 speakers are supported.
         #
-        #   @param known_speaker_references [Array<String>] Optional list of audio samples (as [data URLs](https://developer.mozilla.org/en-
+        #   @param known_speaker_references [Array<String>]
+        #     Optional list of audio samples (as
+        #     [data URLs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs))
+        #     that contain known speaker references matching `known_speaker_names[]`. Each
+        #     sample must be between 2 and 10 seconds, and can use any of the same input audio
+        #     formats supported by `file`.
         #
-        #   @param language [String] The language of the input audio. Supplying the input language in [ISO-639-1](htt
+        #   @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 languages [Array<String>] Possible languages of the input audio, in [ISO-639-1](https://en.wikipedia.org/w
+        #   @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`.
         #
-        #   @param prompt [String] An optional text to guide the model's style or continue a previous audio segment
+        #   @param prompt [String]
+        #     An optional text to guide the model's style or continue a previous audio
+        #     segment. The
+        #     [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting)
+        #     should match the audio language. This field is not supported when using
+        #     `gpt-4o-transcribe-diarize`.
         #
-        #   @param response_format [Symbol, OpenAI::Models::AudioResponseFormat] The format of the output, in one of these options: `json`, `text`, `srt`, `verbo
+        #   @param response_format [Symbol, OpenAI::Models::AudioResponseFormat]
+        #     The format of the output, in one of these options: `json`, `text`, `srt`,
+        #     `verbose_json`, `vtt`, or `diarized_json`. For `gpt-4o-transcribe` and
+        #     `gpt-4o-mini-transcribe`, the only supported format is `json`. For
+        #     `gpt-4o-transcribe-diarize`, the supported formats are `json`, `text`, and
+        #     `diarized_json`, with `diarized_json` required to receive speaker annotations.
         #
-        #   @param temperature [Float] The sampling temperature, between 0 and 1. Higher values like 0.8 will make the
+        #   @param temperature [Float]
+        #     The sampling temperature, between 0 and 1. Higher values like 0.8 will make the
+        #     output more random, while lower values like 0.2 will make it more focused and
+        #     deterministic. If set to 0, the model will use
+        #     [log probability](https://en.wikipedia.org/wiki/Log_probability) to
+        #     automatically increase the temperature until certain thresholds are hit.
         #
-        #   @param timestamp_granularities [Array<Symbol, OpenAI::Models::Audio::TranscriptionCreateParams::TimestampGranularity>] The timestamp granularities to populate for this transcription. `response_format
+        #   @param timestamp_granularities [Array<Symbol, OpenAI::Models::Audio::TranscriptionCreateParams::TimestampGranularity>]
+        #     The timestamp granularities to populate for this transcription.
+        #     `response_format` must be set `verbose_json` to use timestamp granularities.
+        #     Either or both of these options are supported: `word`, or `segment`. Note: There
+        #     is no additional latency for segment timestamps, but generating word timestamps
+        #     incurs additional latency. This option is not available for
+        #     `gpt-4o-transcribe-diarize`.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -235,17 +293,21 @@ module OpenAI
             optional :threshold, Float
 
             # @!method initialize(type:, prefix_padding_ms: nil, silence_duration_ms: nil, threshold: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Audio::TranscriptionCreateParams::ChunkingStrategy::VadConfig}
-            #   for more details.
+            #   @param type [Symbol, OpenAI::Models::Audio::TranscriptionCreateParams::ChunkingStrategy::VadConfig::Type]
+            #     Must be set to `server_vad` to enable manual chunking using server side VAD.
             #
-            #   @param type [Symbol, OpenAI::Models::Audio::TranscriptionCreateParams::ChunkingStrategy::VadConfig::Type] Must be set to `server_vad` to enable manual chunking using server side VAD.
+            #   @param prefix_padding_ms [Integer]
+            #     Amount of audio to include before the VAD detected speech (in milliseconds).
             #
-            #   @param prefix_padding_ms [Integer] Amount of audio to include before the VAD detected speech (in
+            #   @param silence_duration_ms [Integer]
+            #     Duration of silence to detect speech stop (in milliseconds). With shorter values
+            #     the model will respond more quickly, but may jump in on short pauses from the
+            #     user.
             #
-            #   @param silence_duration_ms [Integer] Duration of silence to detect speech stop (in milliseconds).
-            #
-            #   @param threshold [Float] Sensitivity threshold (0.0 to 1.0) for voice activity detection. A
+            #   @param threshold [Float]
+            #     Sensitivity threshold (0.0 to 1.0) for voice activity detection. A higher
+            #     threshold will require louder audio to activate the model, and thus might
+            #     perform better in noisy environments.
 
             # Must be set to `server_vad` to enable manual chunking using server side VAD.
             #

data/lib/openai/models/audio/transcription_diarized.rb

@@ -38,15 +38,20 @@ module OpenAI
         #   Represents a diarized transcription response returned by the model, including
         #   the combined transcript and speaker-segment annotations.
         #
-        #   @param duration [Float] Duration of the input audio in seconds.
+        #   @param duration [Float]
+        #     Duration of the input audio in seconds.
         #
-        #   @param segments [Array<OpenAI::Models::Audio::TranscriptionDiarizedSegment>] Segments of the transcript annotated with timestamps and speaker labels.
+        #   @param segments [Array<OpenAI::Models::Audio::TranscriptionDiarizedSegment>]
+        #     Segments of the transcript annotated with timestamps and speaker labels.
         #
-        #   @param text [String] The concatenated transcript text for the entire audio input.
+        #   @param text [String]
+        #     The concatenated transcript text for the entire audio input.
         #
-        #   @param usage [OpenAI::Models::Audio::TranscriptionDiarized::Usage::Tokens, OpenAI::Models::Audio::TranscriptionDiarized::Usage::Duration] Token or duration usage statistics for the request.
+        #   @param usage [OpenAI::Models::Audio::TranscriptionDiarized::Usage::Tokens, OpenAI::Models::Audio::TranscriptionDiarized::Usage::Duration]
+        #     Token or duration usage statistics for the request.
         #
-        #   @param task [Symbol, :transcribe] The type of task that was run. Always `transcribe`.
+        #   @param task [Symbol, :transcribe]
+        #     The type of task that was run. Always `transcribe`.
 
         # Token or duration usage statistics for the request.
         #
@@ -99,15 +104,20 @@ module OpenAI
             # @!method initialize(input_tokens:, output_tokens:, total_tokens:, input_token_details: nil, type: :tokens)
             #   Usage statistics for models billed by token usage.
             #
-            #   @param input_tokens [Integer] Number of input tokens billed for this request.
+            #   @param input_tokens [Integer]
+            #     Number of input tokens billed for this request.
             #
-            #   @param output_tokens [Integer] Number of output tokens generated.
+            #   @param output_tokens [Integer]
+            #     Number of output tokens generated.
             #
-            #   @param total_tokens [Integer] Total number of tokens used (input + output).
+            #   @param total_tokens [Integer]
+            #     Total number of tokens used (input + output).
             #
-            #   @param input_token_details [OpenAI::Models::Audio::TranscriptionDiarized::Usage::Tokens::InputTokenDetails] Details about the input tokens billed for this request.
+            #   @param input_token_details [OpenAI::Models::Audio::TranscriptionDiarized::Usage::Tokens::InputTokenDetails]
+            #     Details about the input tokens billed for this request.
             #
-            #   @param type [Symbol, :tokens] The type of the usage object. Always `tokens` for this variant.
+            #   @param type [Symbol, :tokens]
+            #     The type of the usage object. Always `tokens` for this variant.
 
             # @see OpenAI::Models::Audio::TranscriptionDiarized::Usage::Tokens#input_token_details
             class InputTokenDetails < OpenAI::Internal::Type::BaseModel
@@ -126,9 +136,11 @@ module OpenAI
               # @!method initialize(audio_tokens: nil, text_tokens: nil)
               #   Details about the input tokens billed for this request.
               #
-              #   @param audio_tokens [Integer] Number of audio tokens billed for this request.
+              #   @param audio_tokens [Integer]
+              #     Number of audio tokens billed for this request.
               #
-              #   @param text_tokens [Integer] Number of text tokens billed for this request.
+              #   @param text_tokens [Integer]
+              #     Number of text tokens billed for this request.
             end
           end
 
@@ -148,9 +160,11 @@ module OpenAI
             # @!method initialize(seconds:, type: :duration)
             #   Usage statistics for models billed by audio input duration.
             #
-            #   @param seconds [Float] Duration of the input audio in seconds.
+            #   @param seconds [Float]
+            #     Duration of the input audio in seconds.
             #
-            #   @param type [Symbol, :duration] The type of the usage object. Always `duration` for this variant.
+            #   @param type [Symbol, :duration]
+            #     The type of the usage object. Always `duration` for this variant.
           end
 
           # @!method self.variants

data/lib/openai/models/audio/transcription_diarized_segment.rb

@@ -43,22 +43,27 @@ module OpenAI
         required :type, const: :"transcript.text.segment"
 
         # @!method initialize(id:, end_:, speaker:, start:, text:, type: :"transcript.text.segment")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Audio::TranscriptionDiarizedSegment} for more details.
-        #
         #   A segment of diarized transcript text with speaker metadata.
         #
-        #   @param id [String] Unique identifier for the segment.
+        #   @param id [String]
+        #     Unique identifier for the segment.
         #
-        #   @param end_ [Float] End timestamp of the segment in seconds.
+        #   @param end_ [Float]
+        #     End timestamp of the segment in seconds.
         #
-        #   @param speaker [String] Speaker label for this segment. When known speakers are provided, the label matc
+        #   @param speaker [String]
+        #     Speaker label for this segment. When known speakers are provided, the label
+        #     matches `known_speaker_names[]`. Otherwise speakers are labeled sequentially
+        #     using capital letters (`A`, `B`, ...).
         #
-        #   @param start [Float] Start timestamp of the segment in seconds.
+        #   @param start [Float]
+        #     Start timestamp of the segment in seconds.
         #
-        #   @param text [String] Transcript text for this segment.
+        #   @param text [String]
+        #     Transcript text for this segment.
         #
-        #   @param type [Symbol, :"transcript.text.segment"] The type of the segment. Always `transcript.text.segment`.
+        #   @param type [Symbol, :"transcript.text.segment"]
+        #     The type of the segment. Always `transcript.text.segment`.
       end
     end
   end

data/lib/openai/models/audio/transcription_language.rb

@@ -13,7 +13,8 @@ module OpenAI
         # @!method initialize(code:)
         #   A language detected in transcribed audio.
         #
-        #   @param code [String] The code of a language detected in the audio.
+        #   @param code [String]
+        #     The code of a language detected in the audio.
       end
     end
   end