telnyx 5.43.0 → 5.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16165a575a8ba5351fd5cbdfd588ec9a502c69181223aac0f594d489f3cb0ece
-  data.tar.gz: d2a6544c0084fa29d9021451ed17fa1c365bc7ca73045d4cadccb13d715cd53d
+  metadata.gz: 7fe268e9f5711b397cebf7cdde7592128a848e61bf2030a7b3cab7d2420f4997
+  data.tar.gz: 2eef9ec8559af1b1562f516b43f741cd886611433a46aaeb5cdaf4878f4a05ff
 SHA512:
-  metadata.gz: 4d81fc785fe00c04ba6e1ad07f323872f5fe6e827b93e397e444aeebe154c5737dd3fdb1e0d1dd296267180b32e56d616dff7656e6b76b3eae27f4f5d9f737e3
-  data.tar.gz: 84913adb37c8857c6f736e00df9626fd7f88a1688a81c562069209f574cf22ae46131af0d0e88bb64d3f7e0b2ac62d9203a60496cce190767e8a6c7cdb4de495
+  metadata.gz: 69e947ca4bd0dda23730add20dab9f170dfd6c7a4bc35b71d169200ead869c7611099a69cadef7684e48b66e8c47fdbde96f4e488f4853e9a81eab93c2f8aea3
+  data.tar.gz: d7283bb88ef4b9439f5c8e15df31a35aba4daabe04699136ceb182334ad17b59d21933f7aec3ec4c5e41a728307d5461786e682bc41898c301088233961e92cc

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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.44.0"
 ```
 
 <!-- x-release-please-end -->

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/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.44.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/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/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/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/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.44.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