openai 0.92.0 → 0.94.0

data/sig/openai/models/live/session_usage_updated_event.rbs

@@ -11,22 +11,45 @@ module OpenAI
         }
 
       class SessionUsageUpdatedEvent < OpenAI::Internal::Type::BaseModel
+        # The unique ID of the Live server event.
         attr_accessor event_id: String
 
+        # The event type, always `session.usage.updated`.
         attr_accessor type: :"session.usage.updated"
 
+        # The cumulative Live audio usage so far.
         attr_accessor usage: OpenAI::Live::SessionUsage
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         attr_reader client_event_id: String?
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         def client_event_id=: (String) -> String
 
+        # The latest measured Live context-window usage. Omitted when the context limit is
+        # unknown.
         attr_reader context_window: OpenAI::Live::SessionUsageUpdatedEvent::ContextWindow?
 
+        # The latest measured Live context-window usage. Omitted when the context limit is
+        # unknown.
         def context_window=: (
           OpenAI::Live::SessionUsageUpdatedEvent::ContextWindow
         ) -> OpenAI::Live::SessionUsageUpdatedEvent::ContextWindow
 
+        # @param event_id
+        #   The unique ID of the Live server event.
+        # @param usage
+        #   The cumulative Live audio usage so far.
+        # @param client_event_id
+        #   The event_id of the client command associated with this server event, when
+        #   supplied.
+        # @param context_window
+        #   The latest measured Live context-window usage. Omitted when the context limit is
+        #   unknown.
+        # @param type
+        #   The event type, always `session.usage.updated`.
         def initialize: (
           event_id: String,
           usage: OpenAI::Live::SessionUsage,
@@ -46,8 +69,13 @@ module OpenAI
         type context_window = { usage_ratio: Float }
 
         class ContextWindow < OpenAI::Internal::Type::BaseModel
+          # The latest active context token count divided by the Live model context limit.
+          # Can decrease after compaction and may lag between measured audio frames.
           attr_accessor usage_ratio: Float
 
+          # @param usage_ratio
+          #   The latest active context token count divided by the Live model context limit.
+          #   Can decrease after compaction and may lag between measured audio frames.
           def initialize: (usage_ratio: Float) -> void
 
           def to_hash: -> { usage_ratio: Float }

data/sig/openai/models/live/thinking_append_event.rbs

@@ -10,14 +10,36 @@ module OpenAI
         }
 
       class ThinkingAppendEvent < OpenAI::Internal::Type::BaseModel
+        # Silent reasoning or progress context, limited to 500 tokens. It does not
+        # directly request speech, but can influence later speech and is not a secrecy
+        # boundary.
         attr_accessor content: String
 
+        # Required, nullable. Set null for general session context, or use the ID from
+        # session.delegation.created for an existing client delegation. Non-null IDs are
+        # not accepted with Responses delegation.
         attr_accessor delegation_id: String?
 
+        # The Live client event type. Always `session.thinking.append`.
         attr_accessor type: :"session.thinking.append"
 
+        # Optional client identifier for correlating this command with a server event's
+        # client_event_id or error.client_event_id.
         attr_accessor event_id: String?
 
+        # @param content
+        #   Silent reasoning or progress context, limited to 500 tokens. It does not
+        #   directly request speech, but can influence later speech and is not a secrecy
+        #   boundary.
+        # @param delegation_id
+        #   Required, nullable. Set null for general session context, or use the ID from
+        #   session.delegation.created for an existing client delegation. Non-null IDs are
+        #   not accepted with Responses delegation.
+        # @param event_id
+        #   Optional client identifier for correlating this command with a server event's
+        #   client_event_id or error.client_event_id.
+        # @param type
+        #   The Live client event type. Always `session.thinking.append`.
         def initialize: (
           content: String,
           delegation_id: String?,

data/sig/openai/models/live/thinking_appended_event.rbs

@@ -11,18 +11,41 @@ module OpenAI
         }
 
       class ThinkingAppendedEvent < OpenAI::Internal::Type::BaseModel
+        # The end of this event on the Live session timeline, in milliseconds from the
+        # beginning of the session. For appended context, this can equal start_ms.
         attr_accessor end_ms: Integer
 
+        # The unique ID of the Live server event.
         attr_accessor event_id: String
 
+        # The start of this event on the Live session timeline, in milliseconds from the
+        # beginning of the session.
         attr_accessor start_ms: Integer
 
+        # The event type, always `session.thinking.appended`.
         attr_accessor type: :"session.thinking.appended"
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         attr_reader client_event_id: String?
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         def client_event_id=: (String) -> String
 
+        # @param end_ms
+        #   The end of this event on the Live session timeline, in milliseconds from the
+        #   beginning of the session. For appended context, this can equal start_ms.
+        # @param event_id
+        #   The unique ID of the Live server event.
+        # @param start_ms
+        #   The start of this event on the Live session timeline, in milliseconds from the
+        #   beginning of the session.
+        # @param client_event_id
+        #   The event_id of the client command associated with this server event, when
+        #   supplied.
+        # @param type
+        #   The event type, always `session.thinking.appended`.
         def initialize: (
           end_ms: Integer,
           event_id: String,

data/sig/openai/models/model.rbs

@@ -10,16 +10,31 @@ module OpenAI
       }
 
     class Model < OpenAI::Internal::Type::BaseModel
+      # The model identifier, which can be referenced in the API endpoints.
       attr_accessor id: String
 
+      # The Unix timestamp (in seconds) when the model was created.
       attr_accessor created: Integer
 
+      # The object type, which is always "model".
       attr_accessor object: :model
 
+      # The organization that owns the model.
       attr_accessor owned_by: String
 
+      # The date when the model will shut down, or null if not announced.
       attr_accessor shutdown_date: Date?
 
+      # @param id
+      #   The model identifier, which can be referenced in the API endpoints.
+      # @param created
+      #   The Unix timestamp (in seconds) when the model was created.
+      # @param owned_by
+      #   The organization that owns the model.
+      # @param shutdown_date
+      #   The date when the model will shut down, or null if not announced.
+      # @param object
+      #   The object type, which is always "model".
       def initialize: (
         id: String,
         created: Integer,

data/sig/openai/models/moderation.rbs

@@ -9,14 +9,26 @@ module OpenAI
       }
 
     class Moderation < OpenAI::Internal::Type::BaseModel
+      # A list of the categories, and whether they are flagged or not.
       attr_accessor categories: OpenAI::Moderation::Categories
 
+      # A list of the categories along with the input type(s) that the score applies to.
       attr_accessor category_applied_input_types: OpenAI::Moderation::CategoryAppliedInputTypes
 
+      # A list of the categories along with their scores as predicted by model.
       attr_accessor category_scores: OpenAI::Moderation::CategoryScores
 
+      # Whether any of the below categories are flagged.
       attr_accessor flagged: bool
 
+      # @param categories
+      #   A list of the categories, and whether they are flagged or not.
+      # @param category_applied_input_types
+      #   A list of the categories along with the input type(s) that the score applies to.
+      # @param category_scores
+      #   A list of the categories along with their scores as predicted by model.
+      # @param flagged
+      #   Whether any of the below categories are flagged.
       def initialize: (
         categories: OpenAI::Moderation::Categories,
         category_applied_input_types: OpenAI::Moderation::CategoryAppliedInputTypes,
@@ -49,32 +61,105 @@ module OpenAI
         }
 
       class Categories < OpenAI::Internal::Type::BaseModel
+        # Content that expresses, incites, or promotes harassing language towards any
+        # target.
         attr_accessor harassment: bool
 
+        # Harassment content that also includes violence or serious harm towards any
+        # target.
         attr_accessor harassment_threatening: bool
 
+        # 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.
         attr_accessor hate: bool
 
+        # 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.
         attr_accessor hate_threatening: bool
 
+        # 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.
         attr_accessor illicit: bool?
 
+        # 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.
         attr_accessor illicit_violent: bool?
 
+        # Content that promotes, encourages, or depicts acts of self-harm, such as
+        # suicide, cutting, and eating disorders.
         attr_accessor self_harm: bool
 
+        # 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.
         attr_accessor self_harm_instructions: bool
 
+        # 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.
         attr_accessor self_harm_intent: bool
 
+        # Content meant to arouse sexual excitement, such as the description of sexual
+        # activity, or that promotes sexual services (excluding sex education and
+        # wellness).
         attr_accessor sexual: bool
 
+        # Sexual content that includes an individual who is under 18 years old.
         attr_accessor sexual_minors: bool
 
+        # Content that depicts death, violence, or physical injury.
         attr_accessor violence: bool
 
+        # Content that depicts death, violence, or physical injury in graphic detail.
         attr_accessor violence_graphic: bool
 
+        # @param harassment
+        #   Content that expresses, incites, or promotes harassing language towards any
+        #   target.
+        # @param harassment_threatening
+        #   Harassment content that also includes violence or serious harm towards any
+        #   target.
+        # @param hate
+        #   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
+        #   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
+        #   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
+        #   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
+        #   Content that promotes, encourages, or depicts acts of self-harm, such as
+        #   suicide, cutting, and eating disorders.
+        # @param self_harm_instructions
+        #   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
+        #   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
+        #   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
+        #   Sexual content that includes an individual who is under 18 years old.
+        # @param violence
+        #   Content that depicts death, violence, or physical injury.
+        # @param violence_graphic
+        #   Content that depicts death, violence, or physical injury in graphic detail.
         def initialize: (
           harassment: bool,
           harassment_threatening: bool,
@@ -126,32 +211,71 @@ module OpenAI
         }
 
       class CategoryAppliedInputTypes < OpenAI::Internal::Type::BaseModel
+        # The applied input type(s) for the category 'harassment'.
         attr_accessor harassment: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::harassment]
 
+        # The applied input type(s) for the category 'harassment/threatening'.
         attr_accessor harassment_threatening: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::harassment_threatening]
 
+        # The applied input type(s) for the category 'hate'.
         attr_accessor hate: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::hate]
 
+        # The applied input type(s) for the category 'hate/threatening'.
         attr_accessor hate_threatening: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::hate_threatening]
 
+        # The applied input type(s) for the category 'illicit'.
         attr_accessor illicit: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::illicit]
 
+        # The applied input type(s) for the category 'illicit/violent'.
         attr_accessor illicit_violent: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::illicit_violent]
 
+        # The applied input type(s) for the category 'self-harm'.
         attr_accessor self_harm: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::self_harm]
 
+        # The applied input type(s) for the category 'self-harm/instructions'.
         attr_accessor self_harm_instructions: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::self_harm_instruction]
 
+        # The applied input type(s) for the category 'self-harm/intent'.
         attr_accessor self_harm_intent: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::self_harm_intent]
 
+        # The applied input type(s) for the category 'sexual'.
         attr_accessor sexual: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::sexual]
 
+        # The applied input type(s) for the category 'sexual/minors'.
         attr_accessor sexual_minors: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::sexual_minor]
 
+        # The applied input type(s) for the category 'violence'.
         attr_accessor violence: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::violence]
 
+        # The applied input type(s) for the category 'violence/graphic'.
         attr_accessor violence_graphic: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::violence_graphic]
 
+        # @param harassment
+        #   The applied input type(s) for the category 'harassment'.
+        # @param harassment_threatening
+        #   The applied input type(s) for the category 'harassment/threatening'.
+        # @param hate
+        #   The applied input type(s) for the category 'hate'.
+        # @param hate_threatening
+        #   The applied input type(s) for the category 'hate/threatening'.
+        # @param illicit
+        #   The applied input type(s) for the category 'illicit'.
+        # @param illicit_violent
+        #   The applied input type(s) for the category 'illicit/violent'.
+        # @param self_harm
+        #   The applied input type(s) for the category 'self-harm'.
+        # @param self_harm_instructions
+        #   The applied input type(s) for the category 'self-harm/instructions'.
+        # @param self_harm_intent
+        #   The applied input type(s) for the category 'self-harm/intent'.
+        # @param sexual
+        #   The applied input type(s) for the category 'sexual'.
+        # @param sexual_minors
+        #   The applied input type(s) for the category 'sexual/minors'.
+        # @param violence
+        #   The applied input type(s) for the category 'violence'.
+        # @param violence_graphic
+        #   The applied input type(s) for the category 'violence/graphic'.
         def initialize: (
           harassment: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::harassment],
           harassment_threatening: ::Array[OpenAI::Models::Moderation::CategoryAppliedInputTypes::harassment_threatening],
@@ -339,32 +463,71 @@ module OpenAI
         }
 
       class CategoryScores < OpenAI::Internal::Type::BaseModel
+        # The score for the category 'harassment'.
         attr_accessor harassment: Float
 
+        # The score for the category 'harassment/threatening'.
         attr_accessor harassment_threatening: Float
 
+        # The score for the category 'hate'.
         attr_accessor hate: Float
 
+        # The score for the category 'hate/threatening'.
         attr_accessor hate_threatening: Float
 
+        # The score for the category 'illicit'.
         attr_accessor illicit: Float
 
+        # The score for the category 'illicit/violent'.
         attr_accessor illicit_violent: Float
 
+        # The score for the category 'self-harm'.
         attr_accessor self_harm: Float
 
+        # The score for the category 'self-harm/instructions'.
         attr_accessor self_harm_instructions: Float
 
+        # The score for the category 'self-harm/intent'.
         attr_accessor self_harm_intent: Float
 
+        # The score for the category 'sexual'.
         attr_accessor sexual: Float
 
+        # The score for the category 'sexual/minors'.
         attr_accessor sexual_minors: Float
 
+        # The score for the category 'violence'.
         attr_accessor violence: Float
 
+        # The score for the category 'violence/graphic'.
         attr_accessor violence_graphic: Float
 
+        # @param harassment
+        #   The score for the category 'harassment'.
+        # @param harassment_threatening
+        #   The score for the category 'harassment/threatening'.
+        # @param hate
+        #   The score for the category 'hate'.
+        # @param hate_threatening
+        #   The score for the category 'hate/threatening'.
+        # @param illicit
+        #   The score for the category 'illicit'.
+        # @param illicit_violent
+        #   The score for the category 'illicit/violent'.
+        # @param self_harm
+        #   The score for the category 'self-harm'.
+        # @param self_harm_instructions
+        #   The score for the category 'self-harm/instructions'.
+        # @param self_harm_intent
+        #   The score for the category 'self-harm/intent'.
+        # @param sexual
+        #   The score for the category 'sexual'.
+        # @param sexual_minors
+        #   The score for the category 'sexual/minors'.
+        # @param violence
+        #   The score for the category 'violence'.
+        # @param violence_graphic
+        #   The score for the category 'violence/graphic'.
         def initialize: (
           harassment: Float,
           harassment_threatening: Float,

data/sig/openai/models/moderation_create_params.rbs

@@ -11,14 +11,32 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # 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.
       attr_accessor input: OpenAI::Models::ModerationCreateParams::input
 
+      # 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).
       attr_reader model: OpenAI::Models::ModerationCreateParams::model?
 
+      # 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).
       def model=: (
         OpenAI::Models::ModerationCreateParams::model
       ) -> OpenAI::Models::ModerationCreateParams::model
 
+      # @param input
+      #   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 model
+      #   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).
       def initialize: (
         input: OpenAI::Models::ModerationCreateParams::input,
         ?model: OpenAI::Models::ModerationCreateParams::model,

data/sig/openai/models/moderation_create_response.rbs

@@ -4,12 +4,21 @@ module OpenAI
       { id: String, model: String, results: ::Array[OpenAI::Moderation] }
 
     class ModerationCreateResponse < OpenAI::Internal::Type::BaseModel
+      # The unique identifier for the moderation request.
       attr_accessor id: String
 
+      # The model used to generate the moderation results.
       attr_accessor model: String
 
+      # A list of moderation objects.
       attr_accessor results: ::Array[OpenAI::Moderation]
 
+      # @param id
+      #   The unique identifier for the moderation request.
+      # @param model
+      #   The model used to generate the moderation results.
+      # @param results
+      #   A list of moderation objects.
       def initialize: (
         id: String,
         model: String,

data/sig/openai/models/moderation_image_url_input.rbs

@@ -7,10 +7,16 @@ module OpenAI
       }
 
     class ModerationImageURLInput < OpenAI::Internal::Type::BaseModel
+      # Contains either an image URL or a data URL for a base64 encoded image.
       attr_accessor image_url: OpenAI::ModerationImageURLInput::ImageURL
 
+      # Always `image_url`.
       attr_accessor type: :image_url
 
+      # @param image_url
+      #   Contains either an image URL or a data URL for a base64 encoded image.
+      # @param type
+      #   Always `image_url`.
       def initialize: (
         image_url: OpenAI::ModerationImageURLInput::ImageURL,
         ?type: :image_url
@@ -24,8 +30,11 @@ module OpenAI
       type image_url = { url: String }
 
       class ImageURL < OpenAI::Internal::Type::BaseModel
+        # Either a URL of the image or the base64 encoded image data.
         attr_accessor url: String
 
+        # @param url
+        #   Either a URL of the image or the base64 encoded image data.
         def initialize: (url: String) -> void
 
         def to_hash: -> { url: String }

data/sig/openai/models/moderation_text_input.rbs

@@ -3,10 +3,16 @@ module OpenAI
     type moderation_text_input = { text: String, ?type: :text }
 
     class ModerationTextInput < OpenAI::Internal::Type::BaseModel
+      # A string of text to classify.
       attr_accessor text: String
 
+      # Always `text`.
       attr_accessor type: :text
 
+      # @param text
+      #   A string of text to classify.
+      # @param type
+      #   Always `text`.
       def initialize: (text: String, ?type: :text) -> void
 
       def to_hash: -> { text: String, ?type: :text }

data/sig/openai/models/other_file_chunking_strategy_object.rbs

@@ -3,8 +3,11 @@ module OpenAI
     type other_file_chunking_strategy_object = { ?type: :other }
 
     class OtherFileChunkingStrategyObject < OpenAI::Internal::Type::BaseModel
+      # Always `other`.
       attr_accessor type: :other
 
+      # @param type
+      #   Always `other`.
       def initialize: (?type: :other) -> void
 
       def to_hash: -> { ?type: :other }

data/sig/openai/models/realtime/audio_transcription.rbs

@@ -12,34 +12,106 @@ module OpenAI
         }
 
       class AudioTranscription < OpenAI::Internal::Type::BaseModel
+        # 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.
         attr_reader delay: 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.
         def delay=: (
           OpenAI::Models::Realtime::AudioTranscription::delay
         ) -> OpenAI::Models::Realtime::AudioTranscription::delay
 
+        # Words or phrases to guide transcription of the input audio. Supported by
+        # `gpt-transcribe` and `gpt-live-transcribe`.
         attr_reader keywords: ::Array[String]?
 
+        # Words or phrases to guide transcription of the input audio. Supported by
+        # `gpt-transcribe` and `gpt-live-transcribe`.
         def keywords=: (::Array[String]) -> ::Array[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.
         attr_reader 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.
         def language=: (String) -> 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`.
         attr_reader 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`.
         def languages=: (::Array[String]) -> ::Array[String]
 
+        # 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.
         attr_reader model: 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.
         def model=: (
           OpenAI::Models::Realtime::AudioTranscription::model
         ) -> OpenAI::Models::Realtime::AudioTranscription::model
 
+        # 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.
         attr_reader 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.
         def prompt=: (String) -> String
 
+        # @param 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 keywords
+        #   Words or phrases to guide transcription of the input audio. Supported by
+        #   `gpt-transcribe` and `gpt-live-transcribe`.
+        # @param language
+        #   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
+        #   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 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 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://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.
         def initialize: (
           ?delay: OpenAI::Models::Realtime::AudioTranscription::delay,
           ?keywords: ::Array[String],