telnyx 5.43.0 → 5.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16165a575a8ba5351fd5cbdfd588ec9a502c69181223aac0f594d489f3cb0ece
-  data.tar.gz: d2a6544c0084fa29d9021451ed17fa1c365bc7ca73045d4cadccb13d715cd53d
+  metadata.gz: 9c0be82d7774523b4c36a553d0d466572d8ef7e5979e0f5853cfb8f6f5297c28
+  data.tar.gz: 782dd17b2bbc69f7dc29f8205ca60ae39b0f4216ce4d09e67fe124672d936388
 SHA512:
-  metadata.gz: 4d81fc785fe00c04ba6e1ad07f323872f5fe6e827b93e397e444aeebe154c5737dd3fdb1e0d1dd296267180b32e56d616dff7656e6b76b3eae27f4f5d9f737e3
-  data.tar.gz: 84913adb37c8857c6f736e00df9626fd7f88a1688a81c562069209f574cf22ae46131af0d0e88bb64d3f7e0b2ac62d9203a60496cce190767e8a6c7cdb4de495
+  metadata.gz: c4c55c4c65b89afa345066bc1d88e668ef3138770fd2d5e038d37864123684ecf8398045bf5ccc5af4f35a12e6984f84e0e4653b598935d987669f5b26544511
+  data.tar.gz: 452fc9facf1492903a8484e3eb6caafa0ce32eb1736ae16c2cd93e5ee36918360dd141c24d240e231c106e9a910cf768158ed16fbb3536fa63782dce2bd96591

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 5.45.0 (2026-02-26)
+
+Full Changelog: [v5.44.0...v5.45.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.44.0...v5.45.0)
+
+### Features
+
+* TELAPPS-ENGDESK-48951 add channels to conf record start ([f6e45ec](https://github.com/team-telnyx/telnyx-ruby/commit/f6e45eca1aeab1f2db9c096f42714790049c823b))
+
+## 5.44.0 (2026-02-26)
+
+Full Changelog: [v5.43.0...v5.44.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.43.0...v5.44.0)
+
+### Features
+
+* Add text-to-speech WebSocket streaming OpenAPI spec ([c6c082b](https://github.com/team-telnyx/telnyx-ruby/commit/c6c082b8a0d47d63c136f7c81e5bd4eceffb2872))
+* **api:** manual updates ([d834462](https://github.com/team-telnyx/telnyx-ruby/commit/d834462641d4d929399bf7dbdef9e1bac6dcde8a))
+
 ## 5.43.0 (2026-02-25)
 
 Full Changelog: [v5.42.0...v5.43.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.42.0...v5.43.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.43.0"
+gem "telnyx", "~> 5.45.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/models/conferences/action_record_start_params.rb

@@ -19,6 +19,13 @@ module Telnyx
                  },
                  api_name: :format
 
+        # @!attribute channels
+        #   When `dual`, final audio file will be stereo recorded with the conference
+        #   creator on the first channel, and the rest on the second channel.
+        #
+        #   @return [Symbol, Telnyx::Models::Conferences::ActionRecordStartParams::Channels, nil]
+        optional :channels, enum: -> { Telnyx::Conferences::ActionRecordStartParams::Channels }
+
         # @!attribute command_id
         #   Use this field to avoid duplicate commands. Telnyx will ignore any command with
         #   the same `command_id` for the same `conference_id`.
@@ -53,12 +60,14 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::Conferences::ActionRecordStartParams::Trim, nil]
         optional :trim, enum: -> { Telnyx::Conferences::ActionRecordStartParams::Trim }
 
-        # @!method initialize(format_:, command_id: nil, custom_file_name: nil, play_beep: nil, region: nil, trim: nil, request_options: {})
+        # @!method initialize(format_:, channels: nil, command_id: nil, custom_file_name: nil, play_beep: nil, region: nil, trim: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Conferences::ActionRecordStartParams} for more details.
         #
         #   @param format_ [Symbol, Telnyx::Models::Conferences::ActionRecordStartParams::Format] The audio file format used when storing the conference recording. Can be either
         #
+        #   @param channels [Symbol, Telnyx::Models::Conferences::ActionRecordStartParams::Channels] When `dual`, final audio file will be stereo recorded with the conference creato
+        #
         #   @param command_id [String] Use this field to avoid duplicate commands. Telnyx will ignore any command with
         #
         #   @param custom_file_name [String] The custom recording file name to be used instead of the default `call_leg_id`.
@@ -83,6 +92,18 @@ module Telnyx
           #   @return [Array<Symbol>]
         end
 
+        # When `dual`, final audio file will be stereo recorded with the conference
+        # creator on the first channel, and the rest on the second channel.
+        module Channels
+          extend Telnyx::Internal::Type::Enum
+
+          SINGLE = :single
+          DUAL = :dual
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # Region where the conference data is located. Defaults to the region defined in
         # user's data locality settings (Europe or US).
         module Region

data/lib/telnyx/models/text_to_speech_stream_params.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::TextToSpeech#stream
+    class TextToSpeechStreamParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute audio_format
+      #   Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+      #   only. Accepted values: `pcm`, `wav`.
+      #
+      #   @return [Symbol, Telnyx::Models::TextToSpeechStreamParams::AudioFormat, nil]
+      optional :audio_format, enum: -> { Telnyx::TextToSpeechStreamParams::AudioFormat }
+
+      # @!attribute disable_cache
+      #   When `true`, bypass the audio cache and generate fresh audio.
+      #
+      #   @return [Boolean, nil]
+      optional :disable_cache, Telnyx::Internal::Type::Boolean
+
+      # @!attribute model_id
+      #   Model identifier for the chosen provider. Examples: `Natural`, `NaturalHD`
+      #   (Telnyx); `Polly.Generative` (AWS).
+      #
+      #   @return [String, nil]
+      optional :model_id, String
+
+      # @!attribute provider
+      #   TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
+      #   provided.
+      #
+      #   @return [Symbol, Telnyx::Models::TextToSpeechStreamParams::Provider, nil]
+      optional :provider, enum: -> { Telnyx::TextToSpeechStreamParams::Provider }
+
+      # @!attribute socket_id
+      #   Client-provided socket identifier for tracking. If not provided, one is
+      #   generated server-side.
+      #
+      #   @return [String, nil]
+      optional :socket_id, String
+
+      # @!attribute voice
+      #   Voice identifier in the format `provider.model_id.voice_id` or
+      #   `provider.voice_id` (e.g. `telnyx.NaturalHD.Telnyx_Alloy` or
+      #   `azure.en-US-AvaMultilingualNeural`). When provided, the `provider`, `model_id`,
+      #   and `voice_id` are extracted automatically. Takes precedence over individual
+      #   `provider`/`model_id`/`voice_id` parameters.
+      #
+      #   @return [String, nil]
+      optional :voice, String
+
+      # @!attribute voice_id
+      #   Voice identifier for the chosen provider.
+      #
+      #   @return [String, nil]
+      optional :voice_id, String
+
+      # @!method initialize(audio_format: nil, disable_cache: nil, model_id: nil, provider: nil, socket_id: nil, voice: nil, voice_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::TextToSpeechStreamParams} for more details.
+      #
+      #   @param audio_format [Symbol, Telnyx::Models::TextToSpeechStreamParams::AudioFormat] Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+      #
+      #   @param disable_cache [Boolean] When `true`, bypass the audio cache and generate fresh audio.
+      #
+      #   @param model_id [String] Model identifier for the chosen provider. Examples: `Natural`, `NaturalHD` (Teln
+      #
+      #   @param provider [Symbol, Telnyx::Models::TextToSpeechStreamParams::Provider] TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is pro
+      #
+      #   @param socket_id [String] Client-provided socket identifier for tracking. If not provided, one is generate
+      #
+      #   @param voice [String] Voice identifier in the format `provider.model_id.voice_id` or `provider.voice_i
+      #
+      #   @param voice_id [String] Voice identifier for the chosen provider.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      # Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+      # only. Accepted values: `pcm`, `wav`.
+      module AudioFormat
+        extend Telnyx::Internal::Type::Enum
+
+        PCM = :pcm
+        WAV = :wav
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
+      # provided.
+      module Provider
+        extend Telnyx::Internal::Type::Enum
+
+        AWS = :aws
+        TELNYX = :telnyx
+        AZURE = :azure
+        ELEVENLABS = :elevenlabs
+        MINIMAX = :minimax
+        MURFAI = :murfai
+        RIME = :rime
+        RESEMBLE = :resemble
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models.rb

@@ -1488,10 +1488,10 @@ module Telnyx
 
   TexmlSecretsParams = Telnyx::Models::TexmlSecretsParams
 
-  TextToSpeechGenerateSpeechParams = Telnyx::Models::TextToSpeechGenerateSpeechParams
-
   TextToSpeechListVoicesParams = Telnyx::Models::TextToSpeechListVoicesParams
 
+  TextToSpeechStreamParams = Telnyx::Models::TextToSpeechStreamParams
+
   TrafficType = Telnyx::Models::TrafficType
 
   Transcription = Telnyx::Models::Transcription

data/lib/telnyx/resources/conferences/actions.rb

@@ -391,12 +391,14 @@ module Telnyx
         #
         # - `conference.recording.saved`
         #
-        # @overload record_start(id, format_:, command_id: nil, custom_file_name: nil, play_beep: nil, region: nil, trim: nil, request_options: {})
+        # @overload record_start(id, format_:, channels: nil, command_id: nil, custom_file_name: nil, play_beep: nil, region: nil, trim: nil, request_options: {})
         #
         # @param id [String] Specifies the conference to record by id or name
         #
         # @param format_ [Symbol, Telnyx::Models::Conferences::ActionRecordStartParams::Format] The audio file format used when storing the conference recording. Can be either
         #
+        # @param channels [Symbol, Telnyx::Models::Conferences::ActionRecordStartParams::Channels] When `dual`, final audio file will be stereo recorded with the conference creato
+        #
         # @param command_id [String] Use this field to avoid duplicate commands. Telnyx will ignore any command with
         #
         # @param custom_file_name [String] The custom recording file name to be used instead of the default `call_leg_id`.

data/lib/telnyx/resources/text_to_speech.rb

@@ -3,55 +3,82 @@
 module Telnyx
   module Resources
     class TextToSpeech
-      # Some parameter documentations has been truncated, see
-      # {Telnyx::Models::TextToSpeechGenerateSpeechParams} for more details.
-      #
-      # Converts the provided text to speech using the specified voice and returns audio
-      # data
+      # Returns a list of voices that can be used with the text to speech commands.
       #
-      # @overload generate_speech(text:, voice:, request_options: {})
+      # @overload list_voices(elevenlabs_api_key_ref: nil, provider: nil, request_options: {})
       #
-      # @param text [String] The text to convert to speech
+      # @param elevenlabs_api_key_ref [String] Reference to your ElevenLabs API key stored in the Telnyx Portal
       #
-      # @param voice [String] The voice ID in the format Provider.ModelId.VoiceId.
+      # @param provider [Symbol, Telnyx::Models::TextToSpeechListVoicesParams::Provider] Filter voices by provider
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [StringIO]
+      # @return [Telnyx::Models::TextToSpeechListVoicesResponse]
       #
-      # @see Telnyx::Models::TextToSpeechGenerateSpeechParams
-      def generate_speech(params)
-        parsed, options = Telnyx::TextToSpeechGenerateSpeechParams.dump_request(params)
+      # @see Telnyx::Models::TextToSpeechListVoicesParams
+      def list_voices(params = {})
+        parsed, options = Telnyx::TextToSpeechListVoicesParams.dump_request(params)
         @client.request(
-          method: :post,
-          path: "text-to-speech/speech",
-          headers: {"accept" => "audio/mpeg"},
-          body: parsed,
-          model: StringIO,
+          method: :get,
+          path: "text-to-speech/voices",
+          query: parsed,
+          model: Telnyx::Models::TextToSpeechListVoicesResponse,
           options: options
         )
       end
 
-      # Returns a list of voices that can be used with the text to speech commands.
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::TextToSpeechStreamParams} for more details.
       #
-      # @overload list_voices(elevenlabs_api_key_ref: nil, provider: nil, request_options: {})
+      # Open a WebSocket connection to stream text and receive synthesized audio in real
+      # time. Authentication is provided via the standard
+      # `Authorization: Bearer <API_KEY>` header. Send JSON frames with text to
+      # synthesize; receive JSON frames containing base64-encoded audio chunks.
       #
-      # @param elevenlabs_api_key_ref [String] Reference to your ElevenLabs API key stored in the Telnyx Portal
+      # Supported providers: `aws`, `telnyx`, `azure`, `murfai`, `minimax`, `rime`,
+      # `resemble`, `elevenlabs`.
       #
-      # @param provider [Symbol, Telnyx::Models::TextToSpeechListVoicesParams::Provider] Filter voices by provider
+      # **Connection flow:**
+      #
+      # 1. Open WebSocket with query parameters specifying provider, voice, and model.
+      # 2. Send an initial handshake message `{"text": " "}` (single space) with
+      #    optional `voice_settings` to initialize the session.
+      # 3. Send text messages as `{"text": "Hello world"}`.
+      # 4. Receive audio chunks as JSON frames with base64-encoded audio.
+      # 5. A final frame with `isFinal: true` indicates the end of audio for the current
+      #    text.
+      #
+      # To interrupt and restart synthesis mid-stream, send `{"force": true}` — the
+      # current worker is stopped and a new one is started.
+      #
+      # @overload stream(audio_format: nil, disable_cache: nil, model_id: nil, provider: nil, socket_id: nil, voice: nil, voice_id: nil, request_options: {})
+      #
+      # @param audio_format [Symbol, Telnyx::Models::TextToSpeechStreamParams::AudioFormat] Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+      #
+      # @param disable_cache [Boolean] When `true`, bypass the audio cache and generate fresh audio.
+      #
+      # @param model_id [String] Model identifier for the chosen provider. Examples: `Natural`, `NaturalHD` (Teln
+      #
+      # @param provider [Symbol, Telnyx::Models::TextToSpeechStreamParams::Provider] TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is pro
+      #
+      # @param socket_id [String] Client-provided socket identifier for tracking. If not provided, one is generate
+      #
+      # @param voice [String] Voice identifier in the format `provider.model_id.voice_id` or `provider.voice_i
+      #
+      # @param voice_id [String] Voice identifier for the chosen provider.
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Models::TextToSpeechListVoicesResponse]
+      # @return [nil]
       #
-      # @see Telnyx::Models::TextToSpeechListVoicesParams
-      def list_voices(params = {})
-        parsed, options = Telnyx::TextToSpeechListVoicesParams.dump_request(params)
+      # @see Telnyx::Models::TextToSpeechStreamParams
+      def stream(params = {})
+        parsed, options = Telnyx::TextToSpeechStreamParams.dump_request(params)
         @client.request(
           method: :get,
-          path: "text-to-speech/voices",
+          path: "text-to-speech/speech",
           query: parsed,
-          model: Telnyx::Models::TextToSpeechListVoicesResponse,
+          model: NilClass,
           options: options
         )
       end

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.43.0"
+  VERSION = "5.45.0"
 end

data/lib/telnyx.rb

@@ -2036,9 +2036,9 @@ require_relative "telnyx/models/texml_application_update_params"
 require_relative "telnyx/models/texml_application_update_response"
 require_relative "telnyx/models/texml_secrets_params"
 require_relative "telnyx/models/texml_secrets_response"
-require_relative "telnyx/models/text_to_speech_generate_speech_params"
 require_relative "telnyx/models/text_to_speech_list_voices_params"
 require_relative "telnyx/models/text_to_speech_list_voices_response"
+require_relative "telnyx/models/text_to_speech_stream_params"
 require_relative "telnyx/models/traffic_type"
 require_relative "telnyx/models/transcription"
 require_relative "telnyx/models/transcription_webhook_event"

data/rbi/telnyx/models/conferences/action_record_start_params.rbi

@@ -24,6 +24,25 @@ module Telnyx
         end
         attr_accessor :format_
 
+        # When `dual`, final audio file will be stereo recorded with the conference
+        # creator on the first channel, and the rest on the second channel.
+        sig do
+          returns(
+            T.nilable(
+              Telnyx::Conferences::ActionRecordStartParams::Channels::OrSymbol
+            )
+          )
+        end
+        attr_reader :channels
+
+        sig do
+          params(
+            channels:
+              Telnyx::Conferences::ActionRecordStartParams::Channels::OrSymbol
+          ).void
+        end
+        attr_writer :channels
+
         # Use this field to avoid duplicate commands. Telnyx will ignore any command with
         # the same `command_id` for the same `conference_id`.
         sig { returns(T.nilable(String)) }
@@ -88,6 +107,8 @@ module Telnyx
           params(
             format_:
               Telnyx::Conferences::ActionRecordStartParams::Format::OrSymbol,
+            channels:
+              Telnyx::Conferences::ActionRecordStartParams::Channels::OrSymbol,
             command_id: String,
             custom_file_name: String,
             play_beep: T::Boolean,
@@ -101,6 +122,9 @@ module Telnyx
           # The audio file format used when storing the conference recording. Can be either
           # `mp3` or `wav`.
           format_:,
+          # When `dual`, final audio file will be stereo recorded with the conference
+          # creator on the first channel, and the rest on the second channel.
+          channels: nil,
           # Use this field to avoid duplicate commands. Telnyx will ignore any command with
           # the same `command_id` for the same `conference_id`.
           command_id: nil,
@@ -124,6 +148,8 @@ module Telnyx
             {
               format_:
                 Telnyx::Conferences::ActionRecordStartParams::Format::OrSymbol,
+              channels:
+                Telnyx::Conferences::ActionRecordStartParams::Channels::OrSymbol,
               command_id: String,
               custom_file_name: String,
               play_beep: T::Boolean,
@@ -174,6 +200,42 @@ module Telnyx
           end
         end
 
+        # When `dual`, final audio file will be stereo recorded with the conference
+        # creator on the first channel, and the rest on the second channel.
+        module Channels
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Telnyx::Conferences::ActionRecordStartParams::Channels
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SINGLE =
+            T.let(
+              :single,
+              Telnyx::Conferences::ActionRecordStartParams::Channels::TaggedSymbol
+            )
+          DUAL =
+            T.let(
+              :dual,
+              Telnyx::Conferences::ActionRecordStartParams::Channels::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Telnyx::Conferences::ActionRecordStartParams::Channels::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         # Region where the conference data is located. Defaults to the region defined in
         # user's data locality settings (Europe or US).
         module Region

data/rbi/telnyx/models/text_to_speech_stream_params.rbi

@@ -0,0 +1,231 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class TextToSpeechStreamParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Telnyx::TextToSpeechStreamParams, Telnyx::Internal::AnyHash)
+        end
+
+      # Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+      # only. Accepted values: `pcm`, `wav`.
+      sig do
+        returns(
+          T.nilable(Telnyx::TextToSpeechStreamParams::AudioFormat::OrSymbol)
+        )
+      end
+      attr_reader :audio_format
+
+      sig do
+        params(
+          audio_format: Telnyx::TextToSpeechStreamParams::AudioFormat::OrSymbol
+        ).void
+      end
+      attr_writer :audio_format
+
+      # When `true`, bypass the audio cache and generate fresh audio.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :disable_cache
+
+      sig { params(disable_cache: T::Boolean).void }
+      attr_writer :disable_cache
+
+      # Model identifier for the chosen provider. Examples: `Natural`, `NaturalHD`
+      # (Telnyx); `Polly.Generative` (AWS).
+      sig { returns(T.nilable(String)) }
+      attr_reader :model_id
+
+      sig { params(model_id: String).void }
+      attr_writer :model_id
+
+      # TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
+      # provided.
+      sig do
+        returns(T.nilable(Telnyx::TextToSpeechStreamParams::Provider::OrSymbol))
+      end
+      attr_reader :provider
+
+      sig do
+        params(
+          provider: Telnyx::TextToSpeechStreamParams::Provider::OrSymbol
+        ).void
+      end
+      attr_writer :provider
+
+      # Client-provided socket identifier for tracking. If not provided, one is
+      # generated server-side.
+      sig { returns(T.nilable(String)) }
+      attr_reader :socket_id
+
+      sig { params(socket_id: String).void }
+      attr_writer :socket_id
+
+      # Voice identifier in the format `provider.model_id.voice_id` or
+      # `provider.voice_id` (e.g. `telnyx.NaturalHD.Telnyx_Alloy` or
+      # `azure.en-US-AvaMultilingualNeural`). When provided, the `provider`, `model_id`,
+      # and `voice_id` are extracted automatically. Takes precedence over individual
+      # `provider`/`model_id`/`voice_id` parameters.
+      sig { returns(T.nilable(String)) }
+      attr_reader :voice
+
+      sig { params(voice: String).void }
+      attr_writer :voice
+
+      # Voice identifier for the chosen provider.
+      sig { returns(T.nilable(String)) }
+      attr_reader :voice_id
+
+      sig { params(voice_id: String).void }
+      attr_writer :voice_id
+
+      sig do
+        params(
+          audio_format: Telnyx::TextToSpeechStreamParams::AudioFormat::OrSymbol,
+          disable_cache: T::Boolean,
+          model_id: String,
+          provider: Telnyx::TextToSpeechStreamParams::Provider::OrSymbol,
+          socket_id: String,
+          voice: String,
+          voice_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+        # only. Accepted values: `pcm`, `wav`.
+        audio_format: nil,
+        # When `true`, bypass the audio cache and generate fresh audio.
+        disable_cache: nil,
+        # Model identifier for the chosen provider. Examples: `Natural`, `NaturalHD`
+        # (Telnyx); `Polly.Generative` (AWS).
+        model_id: nil,
+        # TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
+        # provided.
+        provider: nil,
+        # Client-provided socket identifier for tracking. If not provided, one is
+        # generated server-side.
+        socket_id: nil,
+        # Voice identifier in the format `provider.model_id.voice_id` or
+        # `provider.voice_id` (e.g. `telnyx.NaturalHD.Telnyx_Alloy` or
+        # `azure.en-US-AvaMultilingualNeural`). When provided, the `provider`, `model_id`,
+        # and `voice_id` are extracted automatically. Takes precedence over individual
+        # `provider`/`model_id`/`voice_id` parameters.
+        voice: nil,
+        # Voice identifier for the chosen provider.
+        voice_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            audio_format:
+              Telnyx::TextToSpeechStreamParams::AudioFormat::OrSymbol,
+            disable_cache: T::Boolean,
+            model_id: String,
+            provider: Telnyx::TextToSpeechStreamParams::Provider::OrSymbol,
+            socket_id: String,
+            voice: String,
+            voice_id: String,
+            request_options: Telnyx::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+      # only. Accepted values: `pcm`, `wav`.
+      module AudioFormat
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Telnyx::TextToSpeechStreamParams::AudioFormat)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PCM =
+          T.let(
+            :pcm,
+            Telnyx::TextToSpeechStreamParams::AudioFormat::TaggedSymbol
+          )
+        WAV =
+          T.let(
+            :wav,
+            Telnyx::TextToSpeechStreamParams::AudioFormat::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Telnyx::TextToSpeechStreamParams::AudioFormat::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
+      # provided.
+      module Provider
+        extend Telnyx::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Telnyx::TextToSpeechStreamParams::Provider)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AWS =
+          T.let(:aws, Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol)
+        TELNYX =
+          T.let(
+            :telnyx,
+            Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol
+          )
+        AZURE =
+          T.let(
+            :azure,
+            Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol
+          )
+        ELEVENLABS =
+          T.let(
+            :elevenlabs,
+            Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol
+          )
+        MINIMAX =
+          T.let(
+            :minimax,
+            Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol
+          )
+        MURFAI =
+          T.let(
+            :murfai,
+            Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol
+          )
+        RIME =
+          T.let(:rime, Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol)
+        RESEMBLE =
+          T.let(
+            :resemble,
+            Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Telnyx::TextToSpeechStreamParams::Provider::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models.rbi

@@ -1648,11 +1648,10 @@ module Telnyx
 
   TexmlSecretsParams = Telnyx::Models::TexmlSecretsParams
 
-  TextToSpeechGenerateSpeechParams =
-    Telnyx::Models::TextToSpeechGenerateSpeechParams
-
   TextToSpeechListVoicesParams = Telnyx::Models::TextToSpeechListVoicesParams
 
+  TextToSpeechStreamParams = Telnyx::Models::TextToSpeechStreamParams
+
   TrafficType = Telnyx::Models::TrafficType
 
   Transcription = Telnyx::Models::Transcription

data/rbi/telnyx/resources/conferences/actions.rbi

@@ -410,6 +410,8 @@ module Telnyx
             id: String,
             format_:
               Telnyx::Conferences::ActionRecordStartParams::Format::OrSymbol,
+            channels:
+              Telnyx::Conferences::ActionRecordStartParams::Channels::OrSymbol,
             command_id: String,
             custom_file_name: String,
             play_beep: T::Boolean,
@@ -425,6 +427,9 @@ module Telnyx
           # The audio file format used when storing the conference recording. Can be either
           # `mp3` or `wav`.
           format_:,
+          # When `dual`, final audio file will be stereo recorded with the conference
+          # creator on the first channel, and the rest on the second channel.
+          channels: nil,
           # Use this field to avoid duplicate commands. Telnyx will ignore any command with
           # the same `command_id` for the same `conference_id`.
           command_id: nil,

data/rbi/telnyx/resources/text_to_speech.rbi

@@ -3,34 +3,6 @@
 module Telnyx
   module Resources
     class TextToSpeech
-      # Converts the provided text to speech using the specified voice and returns audio
-      # data
-      sig do
-        params(
-          text: String,
-          voice: String,
-          request_options: Telnyx::RequestOptions::OrHash
-        ).returns(StringIO)
-      end
-      def generate_speech(
-        # The text to convert to speech
-        text:,
-        # The voice ID in the format Provider.ModelId.VoiceId.
-        #
-        # Examples:
-        #
-        # - AWS.Polly.Joanna-Neural
-        # - Azure.en-US-AvaMultilingualNeural
-        # - ElevenLabs.eleven_multilingual_v2.Rachel
-        # - Telnyx.KokoroTTS.af
-        #
-        # Use the `GET /text-to-speech/voices` endpoint to get a complete list of
-        # available voices.
-        voice:,
-        request_options: {}
-      )
-      end
-
       # Returns a list of voices that can be used with the text to speech commands.
       sig do
         params(
@@ -48,6 +20,65 @@ module Telnyx
       )
       end
 
+      # Open a WebSocket connection to stream text and receive synthesized audio in real
+      # time. Authentication is provided via the standard
+      # `Authorization: Bearer <API_KEY>` header. Send JSON frames with text to
+      # synthesize; receive JSON frames containing base64-encoded audio chunks.
+      #
+      # Supported providers: `aws`, `telnyx`, `azure`, `murfai`, `minimax`, `rime`,
+      # `resemble`, `elevenlabs`.
+      #
+      # **Connection flow:**
+      #
+      # 1. Open WebSocket with query parameters specifying provider, voice, and model.
+      # 2. Send an initial handshake message `{"text": " "}` (single space) with
+      #    optional `voice_settings` to initialize the session.
+      # 3. Send text messages as `{"text": "Hello world"}`.
+      # 4. Receive audio chunks as JSON frames with base64-encoded audio.
+      # 5. A final frame with `isFinal: true` indicates the end of audio for the current
+      #    text.
+      #
+      # To interrupt and restart synthesis mid-stream, send `{"force": true}` — the
+      # current worker is stopped and a new one is started.
+      sig do
+        params(
+          audio_format: Telnyx::TextToSpeechStreamParams::AudioFormat::OrSymbol,
+          disable_cache: T::Boolean,
+          model_id: String,
+          provider: Telnyx::TextToSpeechStreamParams::Provider::OrSymbol,
+          socket_id: String,
+          voice: String,
+          voice_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).void
+      end
+      def stream(
+        # Audio output format override. Supported for Telnyx `Natural`/`NaturalHD` models
+        # only. Accepted values: `pcm`, `wav`.
+        audio_format: nil,
+        # When `true`, bypass the audio cache and generate fresh audio.
+        disable_cache: nil,
+        # Model identifier for the chosen provider. Examples: `Natural`, `NaturalHD`
+        # (Telnyx); `Polly.Generative` (AWS).
+        model_id: nil,
+        # TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
+        # provided.
+        provider: nil,
+        # Client-provided socket identifier for tracking. If not provided, one is
+        # generated server-side.
+        socket_id: nil,
+        # Voice identifier in the format `provider.model_id.voice_id` or
+        # `provider.voice_id` (e.g. `telnyx.NaturalHD.Telnyx_Alloy` or
+        # `azure.en-US-AvaMultilingualNeural`). When provided, the `provider`, `model_id`,
+        # and `voice_id` are extracted automatically. Takes precedence over individual
+        # `provider`/`model_id`/`voice_id` parameters.
+        voice: nil,
+        # Voice identifier for the chosen provider.
+        voice_id: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Telnyx::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/telnyx/models/conferences/action_record_start_params.rbs

@@ -4,6 +4,7 @@ module Telnyx
       type action_record_start_params =
         {
           format_: Telnyx::Models::Conferences::ActionRecordStartParams::format_,
+          channels: Telnyx::Models::Conferences::ActionRecordStartParams::channels,
           command_id: String,
           custom_file_name: String,
           play_beep: bool,
@@ -18,6 +19,12 @@ module Telnyx
 
         attr_accessor format_: Telnyx::Models::Conferences::ActionRecordStartParams::format_
 
+        attr_reader channels: Telnyx::Models::Conferences::ActionRecordStartParams::channels?
+
+        def channels=: (
+          Telnyx::Models::Conferences::ActionRecordStartParams::channels
+        ) -> Telnyx::Models::Conferences::ActionRecordStartParams::channels
+
         attr_reader command_id: String?
 
         def command_id=: (String) -> String
@@ -44,6 +51,7 @@ module Telnyx
 
         def initialize: (
           format_: Telnyx::Models::Conferences::ActionRecordStartParams::format_,
+          ?channels: Telnyx::Models::Conferences::ActionRecordStartParams::channels,
           ?command_id: String,
           ?custom_file_name: String,
           ?play_beep: bool,
@@ -54,6 +62,7 @@ module Telnyx
 
         def to_hash: -> {
           format_: Telnyx::Models::Conferences::ActionRecordStartParams::format_,
+          channels: Telnyx::Models::Conferences::ActionRecordStartParams::channels,
           command_id: String,
           custom_file_name: String,
           play_beep: bool,
@@ -73,6 +82,17 @@ module Telnyx
           def self?.values: -> ::Array[Telnyx::Models::Conferences::ActionRecordStartParams::format_]
         end
 
+        type channels = :single | :dual
+
+        module Channels
+          extend Telnyx::Internal::Type::Enum
+
+          SINGLE: :single
+          DUAL: :dual
+
+          def self?.values: -> ::Array[Telnyx::Models::Conferences::ActionRecordStartParams::channels]
+        end
+
         type region = :Australia | :Europe | :"Middle East" | :US
 
         module Region

data/sig/telnyx/models/text_to_speech_stream_params.rbs

@@ -0,0 +1,110 @@
+module Telnyx
+  module Models
+    type text_to_speech_stream_params =
+      {
+        audio_format: Telnyx::Models::TextToSpeechStreamParams::audio_format,
+        disable_cache: bool,
+        model_id: String,
+        provider: Telnyx::Models::TextToSpeechStreamParams::provider,
+        socket_id: String,
+        voice: String,
+        voice_id: String
+      }
+      & Telnyx::Internal::Type::request_parameters
+
+    class TextToSpeechStreamParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      attr_reader audio_format: Telnyx::Models::TextToSpeechStreamParams::audio_format?
+
+      def audio_format=: (
+        Telnyx::Models::TextToSpeechStreamParams::audio_format
+      ) -> Telnyx::Models::TextToSpeechStreamParams::audio_format
+
+      attr_reader disable_cache: bool?
+
+      def disable_cache=: (bool) -> bool
+
+      attr_reader model_id: String?
+
+      def model_id=: (String) -> String
+
+      attr_reader provider: Telnyx::Models::TextToSpeechStreamParams::provider?
+
+      def provider=: (
+        Telnyx::Models::TextToSpeechStreamParams::provider
+      ) -> Telnyx::Models::TextToSpeechStreamParams::provider
+
+      attr_reader socket_id: String?
+
+      def socket_id=: (String) -> String
+
+      attr_reader voice: String?
+
+      def voice=: (String) -> String
+
+      attr_reader voice_id: String?
+
+      def voice_id=: (String) -> String
+
+      def initialize: (
+        ?audio_format: Telnyx::Models::TextToSpeechStreamParams::audio_format,
+        ?disable_cache: bool,
+        ?model_id: String,
+        ?provider: Telnyx::Models::TextToSpeechStreamParams::provider,
+        ?socket_id: String,
+        ?voice: String,
+        ?voice_id: String,
+        ?request_options: Telnyx::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        audio_format: Telnyx::Models::TextToSpeechStreamParams::audio_format,
+        disable_cache: bool,
+        model_id: String,
+        provider: Telnyx::Models::TextToSpeechStreamParams::provider,
+        socket_id: String,
+        voice: String,
+        voice_id: String,
+        request_options: Telnyx::RequestOptions
+      }
+
+      type audio_format = :pcm | :wav
+
+      module AudioFormat
+        extend Telnyx::Internal::Type::Enum
+
+        PCM: :pcm
+        WAV: :wav
+
+        def self?.values: -> ::Array[Telnyx::Models::TextToSpeechStreamParams::audio_format]
+      end
+
+      type provider =
+        :aws
+        | :telnyx
+        | :azure
+        | :elevenlabs
+        | :minimax
+        | :murfai
+        | :rime
+        | :resemble
+
+      module Provider
+        extend Telnyx::Internal::Type::Enum
+
+        AWS: :aws
+        TELNYX: :telnyx
+        AZURE: :azure
+        ELEVENLABS: :elevenlabs
+        MINIMAX: :minimax
+        MURFAI: :murfai
+        RIME: :rime
+        RESEMBLE: :resemble
+
+        def self?.values: -> ::Array[Telnyx::Models::TextToSpeechStreamParams::provider]
+      end
+    end
+  end
+end

data/sig/telnyx/models.rbs

@@ -1431,10 +1431,10 @@ module Telnyx
 
   class TexmlSecretsParams = Telnyx::Models::TexmlSecretsParams
 
-  class TextToSpeechGenerateSpeechParams = Telnyx::Models::TextToSpeechGenerateSpeechParams
-
   class TextToSpeechListVoicesParams = Telnyx::Models::TextToSpeechListVoicesParams
 
+  class TextToSpeechStreamParams = Telnyx::Models::TextToSpeechStreamParams
+
   module TrafficType = Telnyx::Models::TrafficType
 
   class Transcription = Telnyx::Models::Transcription

data/sig/telnyx/resources/conferences/actions.rbs

@@ -112,6 +112,7 @@ module Telnyx
         def record_start: (
           String id,
           format_: Telnyx::Models::Conferences::ActionRecordStartParams::format_,
+          ?channels: Telnyx::Models::Conferences::ActionRecordStartParams::channels,
           ?command_id: String,
           ?custom_file_name: String,
           ?play_beep: bool,

data/sig/telnyx/resources/text_to_speech.rbs

@@ -1,18 +1,23 @@
 module Telnyx
   module Resources
     class TextToSpeech
-      def generate_speech: (
-        text: String,
-        voice: String,
-        ?request_options: Telnyx::request_opts
-      ) -> StringIO
-
       def list_voices: (
         ?elevenlabs_api_key_ref: String,
         ?provider: Telnyx::Models::TextToSpeechListVoicesParams::provider,
         ?request_options: Telnyx::request_opts
       ) -> Telnyx::Models::TextToSpeechListVoicesResponse
 
+      def stream: (
+        ?audio_format: Telnyx::Models::TextToSpeechStreamParams::audio_format,
+        ?disable_cache: bool,
+        ?model_id: String,
+        ?provider: Telnyx::Models::TextToSpeechStreamParams::provider,
+        ?socket_id: String,
+        ?voice: String,
+        ?voice_id: String,
+        ?request_options: Telnyx::request_opts
+      ) -> nil
+
       def initialize: (client: Telnyx::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telnyx
 version: !ruby/object:Gem::Version
-  version: 5.43.0
+  version: 5.45.0
 platform: ruby
 authors:
 - Telnyx
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-25 00:00:00.000000000 Z
+date: 2026-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -2053,9 +2053,9 @@ files:
 - lib/telnyx/models/texml_application_update_response.rb
 - lib/telnyx/models/texml_secrets_params.rb
 - lib/telnyx/models/texml_secrets_response.rb
-- lib/telnyx/models/text_to_speech_generate_speech_params.rb
 - lib/telnyx/models/text_to_speech_list_voices_params.rb
 - lib/telnyx/models/text_to_speech_list_voices_response.rb
+- lib/telnyx/models/text_to_speech_stream_params.rb
 - lib/telnyx/models/traffic_type.rb
 - lib/telnyx/models/transcription.rb
 - lib/telnyx/models/transcription_webhook_event.rb
@@ -4475,9 +4475,9 @@ files:
 - rbi/telnyx/models/texml_application_update_response.rbi
 - rbi/telnyx/models/texml_secrets_params.rbi
 - rbi/telnyx/models/texml_secrets_response.rbi
-- rbi/telnyx/models/text_to_speech_generate_speech_params.rbi
 - rbi/telnyx/models/text_to_speech_list_voices_params.rbi
 - rbi/telnyx/models/text_to_speech_list_voices_response.rbi
+- rbi/telnyx/models/text_to_speech_stream_params.rbi
 - rbi/telnyx/models/traffic_type.rbi
 - rbi/telnyx/models/transcription.rbi
 - rbi/telnyx/models/transcription_webhook_event.rbi
@@ -6896,9 +6896,9 @@ files:
 - sig/telnyx/models/texml_application_update_response.rbs
 - sig/telnyx/models/texml_secrets_params.rbs
 - sig/telnyx/models/texml_secrets_response.rbs
-- sig/telnyx/models/text_to_speech_generate_speech_params.rbs
 - sig/telnyx/models/text_to_speech_list_voices_params.rbs
 - sig/telnyx/models/text_to_speech_list_voices_response.rbs
+- sig/telnyx/models/text_to_speech_stream_params.rbs
 - sig/telnyx/models/traffic_type.rbs
 - sig/telnyx/models/transcription.rbs
 - sig/telnyx/models/transcription_webhook_event.rbs

data/lib/telnyx/models/text_to_speech_generate_speech_params.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-module Telnyx
-  module Models
-    # @see Telnyx::Resources::TextToSpeech#generate_speech
-    class TextToSpeechGenerateSpeechParams < Telnyx::Internal::Type::BaseModel
-      extend Telnyx::Internal::Type::RequestParameters::Converter
-      include Telnyx::Internal::Type::RequestParameters
-
-      # @!attribute text
-      #   The text to convert to speech
-      #
-      #   @return [String]
-      required :text, String
-
-      # @!attribute voice
-      #   The voice ID in the format Provider.ModelId.VoiceId.
-      #
-      #   Examples:
-      #
-      #   - AWS.Polly.Joanna-Neural
-      #   - Azure.en-US-AvaMultilingualNeural
-      #   - ElevenLabs.eleven_multilingual_v2.Rachel
-      #   - Telnyx.KokoroTTS.af
-      #
-      #   Use the `GET /text-to-speech/voices` endpoint to get a complete list of
-      #   available voices.
-      #
-      #   @return [String]
-      required :voice, String
-
-      # @!method initialize(text:, voice:, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {Telnyx::Models::TextToSpeechGenerateSpeechParams} for more details.
-      #
-      #   @param text [String] The text to convert to speech
-      #
-      #   @param voice [String] The voice ID in the format Provider.ModelId.VoiceId.
-      #
-      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
-    end
-  end
-end

data/rbi/telnyx/models/text_to_speech_generate_speech_params.rbi

@@ -1,74 +0,0 @@
-# typed: strong
-
-module Telnyx
-  module Models
-    class TextToSpeechGenerateSpeechParams < Telnyx::Internal::Type::BaseModel
-      extend Telnyx::Internal::Type::RequestParameters::Converter
-      include Telnyx::Internal::Type::RequestParameters
-
-      OrHash =
-        T.type_alias do
-          T.any(
-            Telnyx::TextToSpeechGenerateSpeechParams,
-            Telnyx::Internal::AnyHash
-          )
-        end
-
-      # The text to convert to speech
-      sig { returns(String) }
-      attr_accessor :text
-
-      # The voice ID in the format Provider.ModelId.VoiceId.
-      #
-      # Examples:
-      #
-      # - AWS.Polly.Joanna-Neural
-      # - Azure.en-US-AvaMultilingualNeural
-      # - ElevenLabs.eleven_multilingual_v2.Rachel
-      # - Telnyx.KokoroTTS.af
-      #
-      # Use the `GET /text-to-speech/voices` endpoint to get a complete list of
-      # available voices.
-      sig { returns(String) }
-      attr_accessor :voice
-
-      sig do
-        params(
-          text: String,
-          voice: String,
-          request_options: Telnyx::RequestOptions::OrHash
-        ).returns(T.attached_class)
-      end
-      def self.new(
-        # The text to convert to speech
-        text:,
-        # The voice ID in the format Provider.ModelId.VoiceId.
-        #
-        # Examples:
-        #
-        # - AWS.Polly.Joanna-Neural
-        # - Azure.en-US-AvaMultilingualNeural
-        # - ElevenLabs.eleven_multilingual_v2.Rachel
-        # - Telnyx.KokoroTTS.af
-        #
-        # Use the `GET /text-to-speech/voices` endpoint to get a complete list of
-        # available voices.
-        voice:,
-        request_options: {}
-      )
-      end
-
-      sig do
-        override.returns(
-          {
-            text: String,
-            voice: String,
-            request_options: Telnyx::RequestOptions
-          }
-        )
-      end
-      def to_hash
-      end
-    end
-  end
-end

data/sig/telnyx/models/text_to_speech_generate_speech_params.rbs

@@ -1,28 +0,0 @@
-module Telnyx
-  module Models
-    type text_to_speech_generate_speech_params =
-      { text: String, voice: String }
-      & Telnyx::Internal::Type::request_parameters
-
-    class TextToSpeechGenerateSpeechParams < Telnyx::Internal::Type::BaseModel
-      extend Telnyx::Internal::Type::RequestParameters::Converter
-      include Telnyx::Internal::Type::RequestParameters
-
-      attr_accessor text: String
-
-      attr_accessor voice: String
-
-      def initialize: (
-        text: String,
-        voice: String,
-        ?request_options: Telnyx::request_opts
-      ) -> void
-
-      def to_hash: -> {
-        text: String,
-        voice: String,
-        request_options: Telnyx::RequestOptions
-      }
-    end
-  end
-end