openai 0.22.1 → 0.23.0

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

@@ -11,10 +11,14 @@ module OpenAI
         required :event_id, String
 
         # @!attribute session
-        #   A Realtime transcription session configuration object.
+        #   A new Realtime transcription session configuration.
         #
-        #   @return [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session]
-        required :session, -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session }
+        #   When a session is created on the server via REST API, the session object also
+        #   contains an ephemeral key. Default TTL for keys is 10 minutes. This property is
+        #   not present when a session is updated via the WebSocket API.
+        #
+        #   @return [OpenAI::Models::Realtime::RealtimeTranscriptionSessionCreateResponse]
+        required :session, -> { OpenAI::Realtime::RealtimeTranscriptionSessionCreateResponse }
 
         # @!attribute type
         #   The event type, must be `transcription_session.updated`.
@@ -31,248 +35,9 @@ module OpenAI
         #
         #   @param event_id [String] The unique ID of the server event.
         #
-        #   @param session [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session] A Realtime transcription session configuration object.
+        #   @param session [OpenAI::Models::Realtime::RealtimeTranscriptionSessionCreateResponse] A new Realtime transcription session configuration.
         #
         #   @param type [Symbol, :"transcription_session.updated"] The event type, must be `transcription_session.updated`.
-
-        # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent#session
-        class Session < OpenAI::Internal::Type::BaseModel
-          # @!attribute id
-          #   Unique identifier for the session that looks like `sess_1234567890abcdef`.
-          #
-          #   @return [String, nil]
-          optional :id, String
-
-          # @!attribute audio
-          #   Configuration for input audio for the session.
-          #
-          #   @return [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio, nil]
-          optional :audio, -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio }
-
-          # @!attribute expires_at
-          #   Expiration timestamp for the session, in seconds since epoch.
-          #
-          #   @return [Integer, nil]
-          optional :expires_at, Integer
-
-          # @!attribute include
-          #   Additional fields to include in server outputs.
-          #
-          #   - `item.input_audio_transcription.logprobs`: Include logprobs for input audio
-          #     transcription.
-          #
-          #   @return [Array<Symbol, OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Include>, nil]
-          optional :include,
-                   -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Include] }
-
-          # @!attribute object
-          #   The object type. Always `realtime.transcription_session`.
-          #
-          #   @return [String, nil]
-          optional :object, String
-
-          # @!method initialize(id: nil, audio: nil, expires_at: nil, include: nil, object: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session} for more
-          #   details.
-          #
-          #   A Realtime transcription session configuration object.
-          #
-          #   @param id [String] Unique identifier for the session that looks like `sess_1234567890abcdef`.
-          #
-          #   @param audio [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio] Configuration for input audio for the session.
-          #
-          #   @param expires_at [Integer] Expiration timestamp for the session, in seconds since epoch.
-          #
-          #   @param include [Array<Symbol, OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Include>] Additional fields to include in server outputs.
-          #
-          #   @param object [String] The object type. Always `realtime.transcription_session`.
-
-          # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session#audio
-          class Audio < OpenAI::Internal::Type::BaseModel
-            # @!attribute input
-            #
-            #   @return [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input, nil]
-            optional :input, -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input }
-
-            # @!method initialize(input: nil)
-            #   Configuration for input audio for the session.
-            #
-            #   @param input [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input]
-
-            # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio#input
-            class Input < OpenAI::Internal::Type::BaseModel
-              # @!attribute format_
-              #   The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`.
-              #
-              #   @return [String, nil]
-              optional :format_, String, api_name: :format
-
-              # @!attribute noise_reduction
-              #   Configuration for input audio noise reduction.
-              #
-              #   @return [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction, nil]
-              optional :noise_reduction,
-                       -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction }
-
-              # @!attribute transcription
-              #   Configuration of the transcription model.
-              #
-              #   @return [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription, nil]
-              optional :transcription,
-                       -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription }
-
-              # @!attribute turn_detection
-              #   Configuration for turn detection.
-              #
-              #   @return [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::TurnDetection, nil]
-              optional :turn_detection,
-                       -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::TurnDetection }
-
-              # @!method initialize(format_: nil, noise_reduction: nil, transcription: nil, turn_detection: nil)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input}
-              #   for more details.
-              #
-              #   @param format_ [String] The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`.
-              #
-              #   @param noise_reduction [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction] Configuration for input audio noise reduction.
-              #
-              #   @param transcription [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription] Configuration of the transcription model.
-              #
-              #   @param turn_detection [OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::TurnDetection] Configuration for turn detection.
-
-              # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input#noise_reduction
-              class NoiseReduction < OpenAI::Internal::Type::BaseModel
-                # @!attribute type
-                #
-                #   @return [Symbol, OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction::Type, nil]
-                optional :type,
-                         enum: -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction::Type }
-
-                # @!method initialize(type: nil)
-                #   Configuration for input audio noise reduction.
-                #
-                #   @param type [Symbol, OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction::Type]
-
-                # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::NoiseReduction#type
-                module Type
-                  extend OpenAI::Internal::Type::Enum
-
-                  NEAR_FIELD = :near_field
-                  FAR_FIELD = :far_field
-
-                  # @!method self.values
-                  #   @return [Array<Symbol>]
-                end
-              end
-
-              # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input#transcription
-              class Transcription < OpenAI::Internal::Type::BaseModel
-                # @!attribute 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.
-                #
-                #   @return [String, nil]
-                optional :language, String
-
-                # @!attribute model
-                #   The model to use for transcription. Can be `gpt-4o-transcribe`,
-                #   `gpt-4o-mini-transcribe`, or `whisper-1`.
-                #
-                #   @return [Symbol, OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription::Model, nil]
-                optional :model,
-                         enum: -> { OpenAI::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription::Model }
-
-                # @!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)
-                #   should match the audio language.
-                #
-                #   @return [String, nil]
-                optional :prompt, String
-
-                # @!method initialize(language: nil, model: nil, prompt: nil)
-                #   Some parameter documentations has been truncated, see
-                #   {OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription}
-                #   for more details.
-                #
-                #   Configuration of the transcription model.
-                #
-                #   @param language [String] The language of the input audio. Supplying the input language in
-                #
-                #   @param model [Symbol, OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription::Model] The model to use for transcription. Can be `gpt-4o-transcribe`, `gpt-4o-mini-tra
-                #
-                #   @param prompt [String] An optional text to guide the model's style or continue a previous audio segment
-
-                # The model to use for transcription. Can be `gpt-4o-transcribe`,
-                # `gpt-4o-mini-transcribe`, or `whisper-1`.
-                #
-                # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::Transcription#model
-                module Model
-                  extend OpenAI::Internal::Type::Enum
-
-                  GPT_4O_TRANSCRIBE = :"gpt-4o-transcribe"
-                  GPT_4O_MINI_TRANSCRIBE = :"gpt-4o-mini-transcribe"
-                  WHISPER_1 = :"whisper-1"
-
-                  # @!method self.values
-                  #   @return [Array<Symbol>]
-                end
-              end
-
-              # @see OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input#turn_detection
-              class TurnDetection < OpenAI::Internal::Type::BaseModel
-                # @!attribute prefix_padding_ms
-                #
-                #   @return [Integer, nil]
-                optional :prefix_padding_ms, Integer
-
-                # @!attribute silence_duration_ms
-                #
-                #   @return [Integer, nil]
-                optional :silence_duration_ms, Integer
-
-                # @!attribute threshold
-                #
-                #   @return [Float, nil]
-                optional :threshold, Float
-
-                # @!attribute type
-                #   Type of turn detection, only `server_vad` is currently supported.
-                #
-                #   @return [String, nil]
-                optional :type, String
-
-                # @!method initialize(prefix_padding_ms: nil, silence_duration_ms: nil, threshold: nil, type: nil)
-                #   Some parameter documentations has been truncated, see
-                #   {OpenAI::Models::Realtime::TranscriptionSessionUpdatedEvent::Session::Audio::Input::TurnDetection}
-                #   for more details.
-                #
-                #   Configuration for turn detection.
-                #
-                #   @param prefix_padding_ms [Integer]
-                #
-                #   @param silence_duration_ms [Integer]
-                #
-                #   @param threshold [Float]
-                #
-                #   @param type [String] Type of turn detection, only `server_vad` is currently supported.
-              end
-            end
-          end
-
-          module Include
-            extend OpenAI::Internal::Type::Enum
-
-            ITEM_INPUT_AUDIO_TRANSCRIPTION_LOGPROBS = :"item.input_audio_transcription.logprobs"
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-        end
       end
     end
   end

data/lib/openai/resources/realtime/client_secrets.rb

@@ -7,12 +7,11 @@ module OpenAI
         # Some parameter documentations has been truncated, see
         # {OpenAI::Models::Realtime::ClientSecretCreateParams} for more details.
         #
-        # Create a Realtime session and client secret for either realtime or
-        # transcription.
+        # Create a Realtime client secret with an associated session configuration.
         #
         # @overload create(expires_after: nil, session: nil, request_options: {})
         #
-        # @param expires_after [OpenAI::Models::Realtime::ClientSecretCreateParams::ExpiresAfter] Configuration for the ephemeral token expiration.
+        # @param expires_after [OpenAI::Models::Realtime::ClientSecretCreateParams::ExpiresAfter] Configuration for the client secret expiration. Expiration refers to the time af
         #
         # @param session [OpenAI::Models::Realtime::RealtimeSessionCreateRequest, OpenAI::Models::Realtime::RealtimeTranscriptionSessionCreateRequest] Session configuration to use for the client secret. Choose either a realtime
         #

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.22.1"
+  VERSION = "0.23.0"
 end

data/lib/openai.rb

@@ -380,6 +380,7 @@ require_relative "openai/models/moderation_model"
 require_relative "openai/models/moderation_multi_modal_input"
 require_relative "openai/models/moderation_text_input"
 require_relative "openai/models/other_file_chunking_strategy_object"
+require_relative "openai/models/realtime/audio_transcription"
 require_relative "openai/models/realtime/client_secret_create_params"
 require_relative "openai/models/realtime/client_secret_create_response"
 require_relative "openai/models/realtime/conversation_created_event"
@@ -410,11 +411,16 @@ require_relative "openai/models/realtime/log_prob_properties"
 require_relative "openai/models/realtime/mcp_list_tools_completed"
 require_relative "openai/models/realtime/mcp_list_tools_failed"
 require_relative "openai/models/realtime/mcp_list_tools_in_progress"
+require_relative "openai/models/realtime/models"
+require_relative "openai/models/realtime/noise_reduction_type"
 require_relative "openai/models/realtime/output_audio_buffer_clear_event"
 require_relative "openai/models/realtime/rate_limits_updated_event"
 require_relative "openai/models/realtime/realtime_audio_config"
+require_relative "openai/models/realtime/realtime_audio_config_input"
+require_relative "openai/models/realtime/realtime_audio_config_output"
+require_relative "openai/models/realtime/realtime_audio_formats"
+require_relative "openai/models/realtime/realtime_audio_input_turn_detection"
 require_relative "openai/models/realtime/realtime_client_event"
-require_relative "openai/models/realtime/realtime_client_secret_config"
 require_relative "openai/models/realtime/realtime_conversation_item_assistant_message"
 require_relative "openai/models/realtime/realtime_conversation_item_function_call"
 require_relative "openai/models/realtime/realtime_conversation_item_function_call_output"
@@ -430,20 +436,32 @@ require_relative "openai/models/realtime/realtime_mcp_protocol_error"
 require_relative "openai/models/realtime/realtime_mcp_tool_call"
 require_relative "openai/models/realtime/realtime_mcp_tool_execution_error"
 require_relative "openai/models/realtime/realtime_response"
+require_relative "openai/models/realtime/realtime_response_create_audio_output"
+require_relative "openai/models/realtime/realtime_response_create_mcp_tool"
+require_relative "openai/models/realtime/realtime_response_create_params"
 require_relative "openai/models/realtime/realtime_response_status"
 require_relative "openai/models/realtime/realtime_response_usage"
 require_relative "openai/models/realtime/realtime_response_usage_input_token_details"
 require_relative "openai/models/realtime/realtime_response_usage_output_token_details"
 require_relative "openai/models/realtime/realtime_server_event"
 require_relative "openai/models/realtime/realtime_session"
+require_relative "openai/models/realtime/realtime_session_client_secret"
 require_relative "openai/models/realtime/realtime_session_create_request"
 require_relative "openai/models/realtime/realtime_session_create_response"
 require_relative "openai/models/realtime/realtime_tool_choice_config"
 require_relative "openai/models/realtime/realtime_tools_config"
 require_relative "openai/models/realtime/realtime_tools_config_union"
 require_relative "openai/models/realtime/realtime_tracing_config"
+require_relative "openai/models/realtime/realtime_transcription_session_audio"
+require_relative "openai/models/realtime/realtime_transcription_session_audio_input"
+require_relative "openai/models/realtime/realtime_transcription_session_audio_input_turn_detection"
+require_relative "openai/models/realtime/realtime_transcription_session_client_secret"
 require_relative "openai/models/realtime/realtime_transcription_session_create_request"
+require_relative "openai/models/realtime/realtime_transcription_session_create_response"
+require_relative "openai/models/realtime/realtime_transcription_session_input_audio_transcription"
+require_relative "openai/models/realtime/realtime_transcription_session_turn_detection"
 require_relative "openai/models/realtime/realtime_truncation"
+require_relative "openai/models/realtime/realtime_truncation_retention_ratio"
 require_relative "openai/models/realtime/response_audio_delta_event"
 require_relative "openai/models/realtime/response_audio_done_event"
 require_relative "openai/models/realtime/response_audio_transcript_delta_event"

data/rbi/openai/models/realtime/audio_transcription.rbi

@@ -0,0 +1,132 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Realtime
+      class AudioTranscription < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Realtime::AudioTranscription,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # 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.
+        sig { returns(T.nilable(String)) }
+        attr_reader :language
+
+        sig { params(language: String).void }
+        attr_writer :language
+
+        # The model to use for transcription. Current options are `whisper-1`,
+        # `gpt-4o-transcribe-latest`, `gpt-4o-mini-transcribe`, and `gpt-4o-transcribe`.
+        sig do
+          returns(
+            T.nilable(OpenAI::Realtime::AudioTranscription::Model::OrSymbol)
+          )
+        end
+        attr_reader :model
+
+        sig do
+          params(
+            model: OpenAI::Realtime::AudioTranscription::Model::OrSymbol
+          ).void
+        end
+        attr_writer :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://platform.openai.com/docs/guides/speech-to-text#prompting).
+        # For `gpt-4o-transcribe` models, the prompt is a free text string, for example
+        # "expect words related to technology".
+        sig { returns(T.nilable(String)) }
+        attr_reader :prompt
+
+        sig { params(prompt: String).void }
+        attr_writer :prompt
+
+        sig do
+          params(
+            language: String,
+            model: OpenAI::Realtime::AudioTranscription::Model::OrSymbol,
+            prompt: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          language: nil,
+          # The model to use for transcription. Current options are `whisper-1`,
+          # `gpt-4o-transcribe-latest`, `gpt-4o-mini-transcribe`, and `gpt-4o-transcribe`.
+          model: nil,
+          # 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).
+          # For `gpt-4o-transcribe` models, the prompt is a free text string, for example
+          # "expect words related to technology".
+          prompt: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              language: String,
+              model: OpenAI::Realtime::AudioTranscription::Model::OrSymbol,
+              prompt: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The model to use for transcription. Current options are `whisper-1`,
+        # `gpt-4o-transcribe-latest`, `gpt-4o-mini-transcribe`, and `gpt-4o-transcribe`.
+        module Model
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Realtime::AudioTranscription::Model)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          WHISPER_1 =
+            T.let(
+              :"whisper-1",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
+          GPT_4O_TRANSCRIBE_LATEST =
+            T.let(
+              :"gpt-4o-transcribe-latest",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
+          GPT_4O_MINI_TRANSCRIBE =
+            T.let(
+              :"gpt-4o-mini-transcribe",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
+          GPT_4O_TRANSCRIBE =
+            T.let(
+              :"gpt-4o-transcribe",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/realtime/client_secret_create_params.rbi

@@ -15,7 +15,10 @@ module OpenAI
             )
           end
 
-        # Configuration for the ephemeral token expiration.
+        # Configuration for the client secret expiration. Expiration refers to the time
+        # after which a client secret will no longer be valid for creating sessions. The
+        # session itself may continue after that time once started. A secret can be used
+        # to create multiple sessions until it expires.
         sig do
           returns(
             T.nilable(OpenAI::Realtime::ClientSecretCreateParams::ExpiresAfter)
@@ -69,7 +72,10 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
-          # Configuration for the ephemeral token expiration.
+          # Configuration for the client secret expiration. Expiration refers to the time
+          # after which a client secret will no longer be valid for creating sessions. The
+          # session itself may continue after that time once started. A secret can be used
+          # to create multiple sessions until it expires.
           expires_after: nil,
           # Session configuration to use for the client secret. Choose either a realtime
           # session or a transcription session.
@@ -104,8 +110,9 @@ module OpenAI
               )
             end
 
-          # The anchor point for the ephemeral token expiration. Only `created_at` is
-          # currently supported.
+          # The anchor point for the client secret expiration, meaning that `seconds` will
+          # be added to the `created_at` time of the client secret to produce an expiration
+          # timestamp. Only `created_at` is currently supported.
           sig do
             returns(
               T.nilable(
@@ -124,14 +131,18 @@ module OpenAI
           attr_writer :anchor
 
           # The number of seconds from the anchor point to the expiration. Select a value
-          # between `10` and `7200`.
+          # between `10` and `7200` (2 hours). This default to 600 seconds (10 minutes) if
+          # not specified.
           sig { returns(T.nilable(Integer)) }
           attr_reader :seconds
 
           sig { params(seconds: Integer).void }
           attr_writer :seconds
 
-          # Configuration for the ephemeral token expiration.
+          # Configuration for the client secret expiration. Expiration refers to the time
+          # after which a client secret will no longer be valid for creating sessions. The
+          # session itself may continue after that time once started. A secret can be used
+          # to create multiple sessions until it expires.
           sig do
             params(
               anchor:
@@ -140,11 +151,13 @@ module OpenAI
             ).returns(T.attached_class)
           end
           def self.new(
-            # The anchor point for the ephemeral token expiration. Only `created_at` is
-            # currently supported.
+            # The anchor point for the client secret expiration, meaning that `seconds` will
+            # be added to the `created_at` time of the client secret to produce an expiration
+            # timestamp. Only `created_at` is currently supported.
             anchor: nil,
             # The number of seconds from the anchor point to the expiration. Select a value
-            # between `10` and `7200`.
+            # between `10` and `7200` (2 hours). This default to 600 seconds (10 minutes) if
+            # not specified.
             seconds: nil
           )
           end
@@ -161,8 +174,9 @@ module OpenAI
           def to_hash
           end
 
-          # The anchor point for the ephemeral token expiration. Only `created_at` is
-          # currently supported.
+          # The anchor point for the client secret expiration, meaning that `seconds` will
+          # be added to the `created_at` time of the client secret to produce an expiration
+          # timestamp. Only `created_at` is currently supported.
           module Anchor
             extend OpenAI::Internal::Type::Enum