elevenlabs_client 0.4.0 → 0.6.0

data/lib/elevenlabs_client/endpoints/voices.rb

@@ -110,6 +110,374 @@ module ElevenlabsClient
       @client.delete(endpoint)
     end
 
+    # POST /v1/similar-voices
+    # Returns a list of shared voices similar to the provided audio sample
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/similar-voices
+    #
+    # @param audio_file [IO, File] Audio file to find similar voices for
+    # @param filename [String] Original filename for the audio file
+    # @param options [Hash] Optional parameters
+    # @option options [Float] :similarity_threshold Threshold for voice similarity (0-2)
+    # @option options [Integer] :top_k Number of most similar voices to return (1-100)
+    # @return [Hash] Response containing similar voices
+    def find_similar(audio_file, filename, **options)
+      endpoint = "/v1/similar-voices"
+      
+      payload = {
+        audio_file: @client.file_part(audio_file, filename)
+      }
+      
+      payload[:similarity_threshold] = options[:similarity_threshold] if options[:similarity_threshold]
+      payload[:top_k] = options[:top_k] if options[:top_k]
+
+      @client.post_multipart(endpoint, payload)
+    end
+
+    # POST /v1/voices/add
+    # Creates a new IVC (Instant Voice Cloning) voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/add-voice
+    #
+    # @param name [String] Name of the voice
+    # @param audio_files [Array<IO, File>] Array of audio files for voice cloning
+    # @param filenames [Array<String>] Array of original filenames
+    # @param options [Hash] Optional parameters
+    # @option options [Boolean] :remove_background_noise Remove background noise (default: false)
+    # @option options [String] :description Description of the voice
+    # @option options [String] :labels Serialized labels dictionary
+    # @return [Hash] Response containing voice_id and requires_verification status
+    def create_ivc(name, audio_files, filenames, **options)
+      endpoint = "/v1/voices/add"
+      
+      payload = { name: name }
+      
+      # Add optional parameters
+      payload[:remove_background_noise] = options[:remove_background_noise] unless options[:remove_background_noise].nil?
+      payload[:description] = options[:description] if options[:description]
+      payload[:labels] = options[:labels] if options[:labels]
+      
+      # Add audio files
+      audio_files.each_with_index do |file, index|
+        filename = filenames[index] || "audio_#{index}.mp3"
+        payload["files[]"] = @client.file_part(file, filename)
+      end
+
+      @client.post_multipart(endpoint, payload)
+    end
+
+    # GET /v1/voices/settings/default
+    # Gets the default settings for voices
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/default-settings
+    #
+    # @return [Hash] Default voice settings
+    def get_default_settings
+      endpoint = "/v1/voices/settings/default"
+      @client.get(endpoint)
+    end
+
+    # GET /v1/voices/{voice_id}/settings
+    # Returns the settings for a specific voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-settings
+    #
+    # @param voice_id [String] Voice ID
+    # @return [Hash] Voice settings
+    def get_settings(voice_id)
+      endpoint = "/v1/voices/#{voice_id}/settings"
+      @client.get(endpoint)
+    end
+
+    # POST /v1/voices/{voice_id}/settings/edit
+    # Edit settings for a specific voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/edit-settings
+    #
+    # @param voice_id [String] Voice ID
+    # @param options [Hash] Voice settings to update
+    # @option options [Float] :stability Stability setting (0.0-1.0)
+    # @option options [Boolean] :use_speaker_boost Enable speaker boost
+    # @option options [Float] :similarity_boost Similarity boost setting (0.0-1.0)
+    # @option options [Float] :style Style exaggeration (0.0-1.0)
+    # @option options [Float] :speed Speed adjustment (0.25-4.0)
+    # @return [Hash] Response with status
+    def edit_settings(voice_id, **options)
+      endpoint = "/v1/voices/#{voice_id}/settings/edit"
+      
+      payload = {}
+      payload[:stability] = options[:stability] if options[:stability]
+      payload[:use_speaker_boost] = options[:use_speaker_boost] unless options[:use_speaker_boost].nil?
+      payload[:similarity_boost] = options[:similarity_boost] if options[:similarity_boost]
+      payload[:style] = options[:style] if options[:style]
+      payload[:speed] = options[:speed] if options[:speed]
+
+      @client.post(endpoint, payload)
+    end
+
+    # GET /v1/voices/{voice_id}/samples/{sample_id}/audio
+    # Returns the audio corresponding to a sample attached to a voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-sample-audio
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @return [String] Binary audio data
+    def get_sample_audio(voice_id, sample_id)
+      endpoint = "/v1/voices/#{voice_id}/samples/#{sample_id}/audio"
+      @client.get(endpoint)
+    end
+
+    # POST /v1/voices/pvc
+    # Creates a new PVC (Professional Voice Cloning) voice with metadata but no samples
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/create-pvc
+    #
+    # @param name [String] Name of the voice (max 100 characters)
+    # @param language [String] Language used in the samples
+    # @param options [Hash] Optional parameters
+    # @option options [String] :description Description (max 500 characters)
+    # @option options [Hash] :labels Serialized labels dictionary
+    # @return [Hash] Response containing voice_id
+    def create_pvc(name, language, **options)
+      endpoint = "/v1/voices/pvc"
+      
+      payload = {
+        name: name,
+        language: language
+      }
+      
+      payload[:description] = options[:description] if options[:description]
+      payload[:labels] = options[:labels] if options[:labels]
+
+      @client.post(endpoint, payload)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}
+    # Edit PVC voice metadata
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/update-pvc
+    #
+    # @param voice_id [String] Voice ID
+    # @param options [Hash] Parameters to update
+    # @option options [String] :name New name (max 100 characters)
+    # @option options [String] :language New language
+    # @option options [String] :description New description (max 500 characters)
+    # @option options [Hash] :labels New labels dictionary
+    # @return [Hash] Response containing voice_id
+    def update_pvc(voice_id, **options)
+      endpoint = "/v1/voices/pvc/#{voice_id}"
+      
+      payload = {}
+      payload[:name] = options[:name] if options[:name]
+      payload[:language] = options[:language] if options[:language]
+      payload[:description] = options[:description] if options[:description]
+      payload[:labels] = options[:labels] if options[:labels]
+
+      @client.post(endpoint, payload)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}/train
+    # Start PVC training process for a voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/train-pvc
+    #
+    # @param voice_id [String] Voice ID
+    # @param options [Hash] Optional parameters
+    # @option options [String] :model_id Model ID to use for conversion
+    # @return [Hash] Response with status
+    def train_pvc(voice_id, **options)
+      endpoint = "/v1/voices/pvc/#{voice_id}/train"
+      
+      payload = {}
+      payload[:model_id] = options[:model_id] if options[:model_id]
+
+      @client.post(endpoint, payload)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}/samples
+    # Add audio samples to a PVC voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/add-pvc-samples
+    #
+    # @param voice_id [String] Voice ID
+    # @param audio_files [Array<IO, File>] Audio files for the voice
+    # @param filenames [Array<String>] Original filenames
+    # @param options [Hash] Optional parameters
+    # @option options [Boolean] :remove_background_noise Remove background noise (default: false)
+    # @return [Array<Hash>] Array of sample information
+    def add_pvc_samples(voice_id, audio_files, filenames, **options)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples"
+      
+      payload = {}
+      payload[:remove_background_noise] = options[:remove_background_noise] unless options[:remove_background_noise].nil?
+      
+      # Add audio files
+      audio_files.each_with_index do |file, index|
+        filename = filenames[index] || "audio_#{index}.mp3"
+        payload["files[]"] = @client.file_part(file, filename)
+      end
+
+      @client.post_multipart(endpoint, payload)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}/samples/{sample_id}
+    # Update a PVC voice sample - apply noise removal or select speaker
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/update-pvc-sample
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @param options [Hash] Update parameters
+    # @option options [Boolean] :remove_background_noise Remove background noise
+    # @option options [Array<String>] :selected_speaker_ids Speaker IDs for training
+    # @option options [Integer] :trim_start_time Start time in milliseconds
+    # @option options [Integer] :trim_end_time End time in milliseconds
+    # @return [Hash] Response containing voice_id
+    def update_pvc_sample(voice_id, sample_id, **options)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}"
+      
+      payload = {}
+      payload[:remove_background_noise] = options[:remove_background_noise] unless options[:remove_background_noise].nil?
+      payload[:selected_speaker_ids] = options[:selected_speaker_ids] if options[:selected_speaker_ids]
+      payload[:trim_start_time] = options[:trim_start_time] if options[:trim_start_time]
+      payload[:trim_end_time] = options[:trim_end_time] if options[:trim_end_time]
+
+      @client.post(endpoint, payload)
+    end
+
+    # DELETE /v1/voices/pvc/{voice_id}/samples/{sample_id}
+    # Delete a sample from a PVC voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/delete-pvc-sample
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @return [Hash] Response with status
+    def delete_pvc_sample(voice_id, sample_id)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}"
+      @client.delete(endpoint)
+    end
+
+    # GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/audio
+    # Retrieve voice sample audio with or without noise removal
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-pvc-sample-audio
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @param options [Hash] Optional parameters
+    # @option options [Boolean] :remove_background_noise Remove background noise (default: false)
+    # @return [Hash] Response with base64 audio data and metadata
+    def get_pvc_sample_audio(voice_id, sample_id, **options)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}/audio"
+      
+      params = {}
+      params[:remove_background_noise] = options[:remove_background_noise] unless options[:remove_background_noise].nil?
+
+      @client.get(endpoint, params)
+    end
+
+    # GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/waveform
+    # Retrieve the visual waveform of a voice sample
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-pvc-waveform
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @return [Hash] Response with sample_id and visual_waveform array
+    def get_pvc_sample_waveform(voice_id, sample_id)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}/waveform"
+      @client.get(endpoint)
+    end
+
+    # GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/speakers
+    # Retrieve speaker separation status and detected speakers
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-pvc-speakers
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @return [Hash] Response with separation status and speakers
+    def get_pvc_speaker_separation_status(voice_id, sample_id)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}/speakers"
+      @client.get(endpoint)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}/samples/{sample_id}/separate-speakers
+    # Start speaker separation process for a sample
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/start-speaker-separation
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @return [Hash] Response with status
+    def start_pvc_speaker_separation(voice_id, sample_id)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}/separate-speakers"
+      @client.post(endpoint)
+    end
+
+    # GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/speakers/{speaker_id}/audio
+    # Retrieve separated audio for a specific speaker
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-separated-speaker-audio
+    #
+    # @param voice_id [String] Voice ID
+    # @param sample_id [String] Sample ID
+    # @param speaker_id [String] Speaker ID
+    # @return [Hash] Response with base64 audio data and metadata
+    def get_pvc_separated_speaker_audio(voice_id, sample_id, speaker_id)
+      endpoint = "/v1/voices/pvc/#{voice_id}/samples/#{sample_id}/speakers/#{speaker_id}/audio"
+      @client.get(endpoint)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}/verification
+    # Request manual verification for a PVC voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/request-pvc-verification
+    #
+    # @param voice_id [String] Voice ID
+    # @param verification_files [Array<IO, File>] Verification documents
+    # @param filenames [Array<String>] Original filenames
+    # @param options [Hash] Optional parameters
+    # @option options [String] :extra_text Extra text for verification process
+    # @return [Hash] Response with status
+    def request_pvc_verification(voice_id, verification_files, filenames, **options)
+      endpoint = "/v1/voices/pvc/#{voice_id}/verification"
+      
+      payload = {}
+      payload[:extra_text] = options[:extra_text] if options[:extra_text]
+      
+      # Add verification files
+      verification_files.each_with_index do |file, index|
+        filename = filenames[index] || "verification_#{index}.pdf"
+        payload["files[]"] = @client.file_part(file, filename)
+      end
+
+      @client.post_multipart(endpoint, payload)
+    end
+
+    # GET /v1/voices/pvc/{voice_id}/captcha
+    # Get captcha for PVC voice verification
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/get-pvc-captcha
+    #
+    # @param voice_id [String] Voice ID
+    # @return [Hash] Captcha data
+    def get_pvc_captcha(voice_id)
+      endpoint = "/v1/voices/pvc/#{voice_id}/captcha"
+      @client.get(endpoint)
+    end
+
+    # POST /v1/voices/pvc/{voice_id}/captcha
+    # Submit captcha verification for PVC voice
+    # Documentation: https://elevenlabs.io/docs/api-reference/voices/verify-pvc-captcha
+    #
+    # @param voice_id [String] Voice ID
+    # @param recording_file [IO, File] Audio recording of the user
+    # @param filename [String] Original filename for the recording
+    # @return [Hash] Response with status
+    def verify_pvc_captcha(voice_id, recording_file, filename)
+      endpoint = "/v1/voices/pvc/#{voice_id}/captcha"
+      
+      payload = {
+        recording: @client.file_part(recording_file, filename)
+      }
+
+      @client.post_multipart(endpoint, payload)
+    end
+
+    alias_method :get_voice, :get
+    alias_method :list_voices, :list
+    alias_method :create_voice, :create
+    alias_method :edit_voice, :edit
+    alias_method :delete_voice, :delete
+    alias_method :similar_voices, :find_similar
+    alias_method :default_settings, :get_default_settings
+    alias_method :voice_settings, :get_settings
+    alias_method :update_settings, :edit_settings
+
     # Check if a voice is banned (safety control)
     # @param voice_id [String] The ID of the voice to check
     # @return [Boolean] True if the voice is banned
@@ -133,13 +501,6 @@ module ElevenlabsClient
       false
     end
 
-    # Alias methods for backward compatibility and convenience
-    alias_method :get_voice, :get
-    alias_method :list_voices, :list
-    alias_method :create_voice, :create
-    alias_method :edit_voice, :edit
-    alias_method :delete_voice, :delete
-
     private
 
     attr_reader :client

data/lib/elevenlabs_client/endpoints/websocket_text_to_speech.rb

@@ -0,0 +1,250 @@
+# frozen_string_literal: true
+
+require 'websocket-client-simple'
+require 'json'
+
+module ElevenlabsClient
+  class WebSocketTextToSpeech
+    def initialize(client)
+      @client = client
+      @base_url = client.base_url.gsub('https://', 'wss://').gsub('http://', 'ws://')
+    end
+
+    # Creates a WebSocket connection for real-time text-to-speech streaming
+    # Documentation: https://elevenlabs.io/docs/api-reference/websockets/text-to-speech
+    #
+    # @param voice_id [String] The unique identifier for the voice
+    # @param options [Hash] Optional parameters
+    # @option options [String] :model_id The model ID to use
+    # @option options [String] :language_code ISO 639-1 language code
+    # @option options [Boolean] :enable_logging Enable logging (default: true)
+    # @option options [Boolean] :enable_ssml_parsing Enable SSML parsing (default: false)
+    # @option options [String] :output_format Output audio format
+    # @option options [Integer] :inactivity_timeout Timeout in seconds (default: 20, max: 180)
+    # @option options [Boolean] :sync_alignment Include timing data (default: false)
+    # @option options [Boolean] :auto_mode Reduce latency mode (default: false)
+    # @option options [String] :apply_text_normalization Text normalization ("auto", "on", "off")
+    # @option options [Integer] :seed Deterministic sampling seed (0-4294967295)
+    # @return [WebSocket::Client::Simple::Client] WebSocket client instance
+    def connect_stream_input(voice_id, **options)
+      endpoint = "/v1/text-to-speech/#{voice_id}/stream-input"
+      
+      # Build query parameters in the same order as provided in options
+      allowed_keys = [:model_id, :language_code, :enable_logging, :enable_ssml_parsing, :output_format, :inactivity_timeout, :sync_alignment, :auto_mode, :apply_text_normalization, :seed]
+      pairs = []
+      options.each do |k, v|
+        next unless allowed_keys.include?(k)
+        next if v.nil?
+        next if (k == :language_code || k == :apply_text_normalization) && v.to_s.empty?
+        pairs << [k, v]
+      end
+      if pairs.any?
+        query_string = pairs.map { |k, v| "#{k}=#{v}" }.join("&")
+        endpoint += "?#{query_string}"
+      end
+      
+      url = "#{@base_url}#{endpoint}"
+      headers = { "xi-api-key" => @client.api_key }
+      
+      WebSocket::Client::Simple.connect(url, headers: headers)
+    end
+
+    # Creates a WebSocket connection for multi-context text-to-speech streaming
+    # Documentation: https://elevenlabs.io/docs/api-reference/websockets/multi-context
+    #
+    # @param voice_id [String] The unique identifier for the voice
+    # @param options [Hash] Optional parameters (same as connect_stream_input)
+    # @return [WebSocket::Client::Simple::Client] WebSocket client instance
+    def connect_multi_stream_input(voice_id, **options)
+      endpoint = "/v1/text-to-speech/#{voice_id}/multi-stream-input"
+      
+      # Build query parameters in the same order as provided in options
+      allowed_keys = [:model_id, :language_code, :enable_logging, :enable_ssml_parsing, :output_format, :inactivity_timeout, :sync_alignment, :auto_mode, :apply_text_normalization, :seed]
+      pairs = []
+      options.each do |k, v|
+        next unless allowed_keys.include?(k)
+        next if v.nil?
+        next if (k == :language_code || k == :apply_text_normalization) && v.to_s.empty?
+        pairs << [k, v]
+      end
+      if pairs.any?
+        query_string = pairs.map { |k, v| "#{k}=#{v}" }.join("&")
+        endpoint += "?#{query_string}"
+      end
+      
+      url = "#{@base_url}#{endpoint}"
+      headers = { "xi-api-key" => @client.api_key }
+      
+      WebSocket::Client::Simple.connect(url, headers: headers)
+    end
+
+    # Helper method to send initialization message for single stream
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param options [Hash] Initialization options
+    # @option options [String] :text Initial text (usually a space)
+    # @option options [Hash] :voice_settings Voice settings hash
+    # @option options [String] :xi_api_key API key (will use client's key if not provided)
+    def send_initialize_connection(ws, **options)
+      message = {
+        text: options[:text] || " ",
+        voice_settings: options[:voice_settings] || {},
+        xi_api_key: options[:xi_api_key] || @client.api_key
+      }
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to send text for single stream
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param text [String] Text to convert to speech
+    # @param options [Hash] Optional parameters
+    # @option options [Boolean] :try_trigger_generation Try to trigger generation
+    # @option options [Hash] :voice_settings Voice settings override
+    def send_text(ws, text, **options)
+      message = { text: text }
+      message[:try_trigger_generation] = options[:try_trigger_generation] unless options[:try_trigger_generation].nil?
+      message[:voice_settings] = options[:voice_settings] if options[:voice_settings]
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to close connection for single stream
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    def send_close_connection(ws)
+      message = { text: "" }
+      ws.send(message.to_json)
+    end
+
+    # Helper method to send initialization message for multi-context stream
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param context_id [String] Context identifier
+    # @param options [Hash] Initialization options
+    def send_initialize_connection_multi(ws, context_id, **options)
+      message = {
+        text: options[:text] || " ",
+        voice_settings: options[:voice_settings] || {},
+        context_id: context_id
+      }
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to initialize a new context in multi-stream
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param context_id [String] Context identifier
+    # @param options [Hash] Context options
+    def send_initialize_context(ws, context_id, **options)
+      message = {
+        context_id: context_id,
+        voice_settings: options[:voice_settings] || {}
+      }
+      message[:model_id] = options[:model_id] if options[:model_id]
+      message[:language_code] = options[:language_code] if options[:language_code]
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to send text for multi-context stream
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param context_id [String] Context identifier
+    # @param text [String] Text to convert to speech
+    # @param options [Hash] Optional parameters
+    def send_text_multi(ws, context_id, text, **options)
+      message = {
+        text: text,
+        context_id: context_id
+      }
+      message[:flush] = options[:flush] unless options[:flush].nil?
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to flush a context
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param context_id [String] Context identifier
+    def send_flush_context(ws, context_id)
+      message = {
+        context_id: context_id,
+        flush: true
+      }
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to close a specific context
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param context_id [String] Context identifier
+    def send_close_context(ws, context_id)
+      message = {
+        context_id: context_id,
+        close_context: true
+      }
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to keep a context alive
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    # @param context_id [String] Context identifier
+    def send_keep_context_alive(ws, context_id)
+      message = {
+        context_id: context_id,
+        keep_context_alive: true
+      }
+      
+      ws.send(message.to_json)
+    end
+
+    # Helper method to close the entire socket
+    # @param ws [WebSocket::Client::Simple::Client] WebSocket client
+    def send_close_socket(ws)
+      message = { close_socket: true }
+      ws.send(message.to_json)
+    end
+
+    # Convenience method to create a complete streaming session
+    # @param voice_id [String] The unique identifier for the voice
+    # @param text_chunks [Array<String>] Array of text chunks to stream
+    # @param options [Hash] Connection and voice options
+    # @param block [Proc] Block to handle audio chunks
+    def stream_text_to_speech(voice_id, text_chunks, **options, &block)
+      ws = connect_stream_input(voice_id, **options)
+      
+      ws.on :open do
+        # Initialize connection
+        send_initialize_connection(ws, **options)
+        
+        # Send text chunks
+        text_chunks.each_with_index do |chunk, index|
+          send_text(ws, chunk, try_trigger_generation: (index == text_chunks.length - 1))
+        end
+        
+        # Close connection
+        send_close_connection(ws)
+      end
+      
+      ws.on :message do |msg|
+        data = JSON.parse(msg.data)
+        if data['audio'] && block_given?
+          # Decode base64 audio and yield to block
+          audio_data = Base64.decode64(data['audio'])
+          block.call(audio_data, data)
+        end
+      end
+      
+      ws.on :error do |e|
+        raise APIError, "WebSocket error: #{e.message}"
+      end
+      
+      ws
+    end
+
+    # Alias methods for convenience
+    alias_method :connect_single_stream, :connect_stream_input
+    alias_method :connect_multi_context, :connect_multi_stream_input
+
+    private
+
+    attr_reader :client
+  end
+end

data/lib/elevenlabs_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ElevenlabsClient
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/elevenlabs_client.rb

@@ -5,18 +5,25 @@ require_relative "elevenlabs_client/errors"
 require_relative "elevenlabs_client/settings"
 require_relative "elevenlabs_client/endpoints/dubs"
 require_relative "elevenlabs_client/endpoints/text_to_speech"
-require_relative "elevenlabs_client/endpoints/text_to_speech_stream"
 require_relative "elevenlabs_client/endpoints/text_to_dialogue"
 require_relative "elevenlabs_client/endpoints/sound_generation"
 require_relative "elevenlabs_client/endpoints/text_to_voice"
-require_relative "elevenlabs_client/endpoints/models"
+require_relative "elevenlabs_client/endpoints/admin/models"
+require_relative "elevenlabs_client/endpoints/admin/history"
+require_relative "elevenlabs_client/endpoints/admin/usage"
+require_relative "elevenlabs_client/endpoints/admin/user"
+require_relative "elevenlabs_client/endpoints/admin/voice_library"
 require_relative "elevenlabs_client/endpoints/voices"
 require_relative "elevenlabs_client/endpoints/music"
+require_relative "elevenlabs_client/endpoints/audio_isolation"
+require_relative "elevenlabs_client/endpoints/audio_native"
+require_relative "elevenlabs_client/endpoints/forced_alignment"
+require_relative "elevenlabs_client/endpoints/speech_to_speech"
+require_relative "elevenlabs_client/endpoints/speech_to_text"
+require_relative "elevenlabs_client/endpoints/websocket_text_to_speech"
 require_relative "elevenlabs_client/client"
 
 module ElevenlabsClient
-  class Error < StandardError; end
-
   # Convenience method to create a new client
   def self.new(**options)
     Client.new(**options)