openai 0.20.0 → 0.21.0

data/rbi/openai/models/realtime/client_secret_create_response.rbi

@@ -0,0 +1,676 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Realtime
+      class ClientSecretCreateResponse < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Models::Realtime::ClientSecretCreateResponse,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Expiration timestamp for the client secret, in seconds since epoch.
+        sig { returns(Integer) }
+        attr_accessor :expires_at
+
+        # The session configuration for either a realtime or transcription session.
+        sig do
+          returns(
+            OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::Variants
+          )
+        end
+        attr_accessor :session
+
+        # The generated client secret value.
+        sig { returns(String) }
+        attr_accessor :value
+
+        # Response from creating a session and client secret for the Realtime API.
+        sig do
+          params(
+            expires_at: Integer,
+            session:
+              T.any(
+                OpenAI::Realtime::RealtimeSessionCreateResponse::OrHash,
+                OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::OrHash
+              ),
+            value: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Expiration timestamp for the client secret, in seconds since epoch.
+          expires_at:,
+          # The session configuration for either a realtime or transcription session.
+          session:,
+          # The generated client secret value.
+          value:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              expires_at: Integer,
+              session:
+                OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::Variants,
+              value: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The session configuration for either a realtime or transcription session.
+        module Session
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                OpenAI::Realtime::RealtimeSessionCreateResponse,
+                OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse
+              )
+            end
+
+          class RealtimeTranscriptionSessionCreateResponse < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # Unique identifier for the session that looks like `sess_1234567890abcdef`.
+            sig { returns(T.nilable(String)) }
+            attr_reader :id
+
+            sig { params(id: String).void }
+            attr_writer :id
+
+            # Configuration for input audio for the session.
+            sig do
+              returns(
+                T.nilable(
+                  OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio
+                )
+              )
+            end
+            attr_reader :audio
+
+            sig do
+              params(
+                audio:
+                  OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::OrHash
+              ).void
+            end
+            attr_writer :audio
+
+            # Expiration timestamp for the session, in seconds since epoch.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :expires_at
+
+            sig { params(expires_at: Integer).void }
+            attr_writer :expires_at
+
+            # Additional fields to include in server outputs.
+            #
+            # - `item.input_audio_transcription.logprobs`: Include logprobs for input audio
+            #   transcription.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include::TaggedSymbol
+                  ]
+                )
+              )
+            end
+            attr_reader :include
+
+            sig do
+              params(
+                include:
+                  T::Array[
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include::OrSymbol
+                  ]
+              ).void
+            end
+            attr_writer :include
+
+            # The object type. Always `realtime.transcription_session`.
+            sig { returns(T.nilable(String)) }
+            attr_reader :object
+
+            sig { params(object: String).void }
+            attr_writer :object
+
+            # A Realtime transcription session configuration object.
+            sig do
+              params(
+                id: String,
+                audio:
+                  OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::OrHash,
+                expires_at: Integer,
+                include:
+                  T::Array[
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include::OrSymbol
+                  ],
+                object: String
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Unique identifier for the session that looks like `sess_1234567890abcdef`.
+              id: nil,
+              # Configuration for input audio for the session.
+              audio: nil,
+              # Expiration timestamp for the session, in seconds since epoch.
+              expires_at: nil,
+              # Additional fields to include in server outputs.
+              #
+              # - `item.input_audio_transcription.logprobs`: Include logprobs for input audio
+              #   transcription.
+              include: nil,
+              # The object type. Always `realtime.transcription_session`.
+              object: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: String,
+                  audio:
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio,
+                  expires_at: Integer,
+                  include:
+                    T::Array[
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include::TaggedSymbol
+                    ],
+                  object: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Audio < OpenAI::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+              sig do
+                returns(
+                  T.nilable(
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input
+                  )
+                )
+              end
+              attr_reader :input
+
+              sig do
+                params(
+                  input:
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::OrHash
+                ).void
+              end
+              attr_writer :input
+
+              # Configuration for input audio for the session.
+              sig do
+                params(
+                  input:
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::OrHash
+                ).returns(T.attached_class)
+              end
+              def self.new(input: nil)
+              end
+
+              sig do
+                override.returns(
+                  {
+                    input:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Input < OpenAI::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input,
+                      OpenAI::Internal::AnyHash
+                    )
+                  end
+
+                # The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`.
+                sig { returns(T.nilable(String)) }
+                attr_reader :format_
+
+                sig { params(format_: String).void }
+                attr_writer :format_
+
+                # Configuration for input audio noise reduction.
+                sig do
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction
+                    )
+                  )
+                end
+                attr_reader :noise_reduction
+
+                sig do
+                  params(
+                    noise_reduction:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::OrHash
+                  ).void
+                end
+                attr_writer :noise_reduction
+
+                # Configuration of the transcription model.
+                sig do
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription
+                    )
+                  )
+                end
+                attr_reader :transcription
+
+                sig do
+                  params(
+                    transcription:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::OrHash
+                  ).void
+                end
+                attr_writer :transcription
+
+                # Configuration for turn detection.
+                sig do
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection
+                    )
+                  )
+                end
+                attr_reader :turn_detection
+
+                sig do
+                  params(
+                    turn_detection:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection::OrHash
+                  ).void
+                end
+                attr_writer :turn_detection
+
+                sig do
+                  params(
+                    format_: String,
+                    noise_reduction:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::OrHash,
+                    transcription:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::OrHash,
+                    turn_detection:
+                      OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection::OrHash
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # The format of input audio. Options are `pcm16`, `g711_ulaw`, or `g711_alaw`.
+                  format_: nil,
+                  # Configuration for input audio noise reduction.
+                  noise_reduction: nil,
+                  # Configuration of the transcription model.
+                  transcription: nil,
+                  # Configuration for turn detection.
+                  turn_detection: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      format_: String,
+                      noise_reduction:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction,
+                      transcription:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription,
+                      turn_detection:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                class NoiseReduction < OpenAI::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction,
+                        OpenAI::Internal::AnyHash
+                      )
+                    end
+
+                  sig do
+                    returns(
+                      T.nilable(
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::TaggedSymbol
+                      )
+                    )
+                  end
+                  attr_reader :type
+
+                  sig do
+                    params(
+                      type:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::OrSymbol
+                    ).void
+                  end
+                  attr_writer :type
+
+                  # Configuration for input audio noise reduction.
+                  sig do
+                    params(
+                      type:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::OrSymbol
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(type: nil)
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        type:
+                          OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::TaggedSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  module Type
+                    extend OpenAI::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    NEAR_FIELD =
+                      T.let(
+                        :near_field,
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::TaggedSymbol
+                      )
+                    FAR_FIELD =
+                      T.let(
+                        :far_field,
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::NoiseReduction::Type::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                class Transcription < OpenAI::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription,
+                        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. Can be `gpt-4o-transcribe`,
+                  # `gpt-4o-mini-transcribe`, or `whisper-1`.
+                  sig do
+                    returns(
+                      T.nilable(
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::TaggedSymbol
+                      )
+                    )
+                  end
+                  attr_reader :model
+
+                  sig do
+                    params(
+                      model:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::OrSymbol
+                    ).void
+                  end
+                  attr_writer :model
+
+                  # 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.
+                  sig { returns(T.nilable(String)) }
+                  attr_reader :prompt
+
+                  sig { params(prompt: String).void }
+                  attr_writer :prompt
+
+                  # Configuration of the transcription model.
+                  sig do
+                    params(
+                      language: String,
+                      model:
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::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. Can be `gpt-4o-transcribe`,
+                    # `gpt-4o-mini-transcribe`, or `whisper-1`.
+                    model: nil,
+                    # 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.
+                    prompt: nil
+                  )
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        language: String,
+                        model:
+                          OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::TaggedSymbol,
+                        prompt: String
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  # The model to use for transcription. Can be `gpt-4o-transcribe`,
+                  # `gpt-4o-mini-transcribe`, or `whisper-1`.
+                  module Model
+                    extend OpenAI::Internal::Type::Enum
+
+                    TaggedSymbol =
+                      T.type_alias do
+                        T.all(
+                          Symbol,
+                          OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    GPT_4O_TRANSCRIBE =
+                      T.let(
+                        :"gpt-4o-transcribe",
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::TaggedSymbol
+                      )
+                    GPT_4O_MINI_TRANSCRIBE =
+                      T.let(
+                        :"gpt-4o-mini-transcribe",
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::TaggedSymbol
+                      )
+                    WHISPER_1 =
+                      T.let(
+                        :"whisper-1",
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::Transcription::Model::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                class TurnDetection < OpenAI::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Audio::Input::TurnDetection,
+                        OpenAI::Internal::AnyHash
+                      )
+                    end
+
+                  sig { returns(T.nilable(Integer)) }
+                  attr_reader :prefix_padding_ms
+
+                  sig { params(prefix_padding_ms: Integer).void }
+                  attr_writer :prefix_padding_ms
+
+                  sig { returns(T.nilable(Integer)) }
+                  attr_reader :silence_duration_ms
+
+                  sig { params(silence_duration_ms: Integer).void }
+                  attr_writer :silence_duration_ms
+
+                  sig { returns(T.nilable(Float)) }
+                  attr_reader :threshold
+
+                  sig { params(threshold: Float).void }
+                  attr_writer :threshold
+
+                  # Type of turn detection, only `server_vad` is currently supported.
+                  sig { returns(T.nilable(String)) }
+                  attr_reader :type
+
+                  sig { params(type: String).void }
+                  attr_writer :type
+
+                  # Configuration for turn detection.
+                  sig do
+                    params(
+                      prefix_padding_ms: Integer,
+                      silence_duration_ms: Integer,
+                      threshold: Float,
+                      type: String
+                    ).returns(T.attached_class)
+                  end
+                  def self.new(
+                    prefix_padding_ms: nil,
+                    silence_duration_ms: nil,
+                    threshold: nil,
+                    # Type of turn detection, only `server_vad` is currently supported.
+                    type: nil
+                  )
+                  end
+
+                  sig do
+                    override.returns(
+                      {
+                        prefix_padding_ms: Integer,
+                        silence_duration_ms: Integer,
+                        threshold: Float,
+                        type: String
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+                end
+              end
+            end
+
+            module Include
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              ITEM_INPUT_AUDIO_TRANSCRIPTION_LOGPROBS =
+                T.let(
+                  :"item.input_audio_transcription.logprobs",
+                  OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::RealtimeTranscriptionSessionCreateResponse::Include::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Models::Realtime::ClientSecretCreateResponse::Session::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
+      end
+    end
+  end
+end